Skip to main content

Support Tokens

Support tokens

Payout preview requires support_networks and support_tokens. This endpoint returns the allowlist for one chain. Copy the arrays into Preview Payout as a subset (typically the full list for that chain).

This catalog is not the same as Payin Currencies. Payin lists receiving / paying tokens for checkout; this list is the payout transfer and gas-token allowlist.

All requests must be authenticated with your API Key. Do not send merchant_id.

Base URL

https://pay-openapi.morph.network/pro/merchant/payout/v1

Endpoint paths in this page are relative to that base URL.

Response envelope

{
"error_code": 0,
"msg": "success",
"data": {},
"trace": "..."
}
note

Business success or failure is determined by error_code (error_code == 0 means success), not by the HTTP status code alone. See Error Codes.

Get support tokens

GET /support-tokens

Query parameters

ParameterTypeRequiredDescription
chain_codestringYesChain identifier, for example morph, sol, trx.

Omitting chain_code is rejected with error_code: 90000.

Request example

GET /pro/merchant/payout/v1/support-tokens?chain_code=morph

Success response

{
"error_code": 0,
"msg": "success",
"data": {
"chain_code": "morph",
"support_networks": ["morph"],
"support_tokens": [
{
"network": "morph",
"address": "0xToken...",
"symbol": "USDT"
}
]
},
"trace": "..."
}

Pass support_networks and support_tokens on preview without renaming fields. Preview is single-chain: every support_networks[] entry must equal tx_intent.chain.

Errors

error_codeMeaningDescription
0Success
90000Invalid parametersMissing chain_code.
90001UnauthorizedAuthentication failed or merchant identity is missing.
8000080099System errorRetry later; include trace if it persists.