curl --request PUT \
--url https://api-beta.pepay.io/api/v1/merchant/settlement-token \
--header 'Content-Type: application/json' \
--data '
{
"settlement_token_id": 5
}
'{
"success": true,
"message": "Settlement token updated successfully",
"settlement_token": {
"id": 5,
"token_symbol": "USDC",
"token_name": "USD Coin",
"network": "ethereum"
},
"updated_at": 123
}{
"error": "Selected token does not support stable settlement",
"code": "INVALID_SETTLEMENT_TOKEN"
}Merchant
Update stable settlement token selection
Allows merchants to select their preferred stable coin token for settlements when their settlement preference is set to receive stable coins.
Important Notes:
- Only tokens with
supports_stable_settlement = truecan be selected - Token must be active and from the merchant’s network environment (mainnet/devnet)
- Setting to null will revert to the system default
- Only affects mainnet merchants (devnet always uses test tokens)
PUT
/
api
/
v1
/
merchant
/
settlement-token
curl --request PUT \
--url https://api-beta.pepay.io/api/v1/merchant/settlement-token \
--header 'Content-Type: application/json' \
--data '
{
"settlement_token_id": 5
}
'{
"success": true,
"message": "Settlement token updated successfully",
"settlement_token": {
"id": 5,
"token_symbol": "USDC",
"token_name": "USD Coin",
"network": "ethereum"
},
"updated_at": 123
}{
"error": "Selected token does not support stable settlement",
"code": "INVALID_SETTLEMENT_TOKEN"
}Body
application/json
ID of the stable settlement token to select. Must be from the available_stable_tokens list. Set to null to use system default.
Example:
5
Was this page helpful?