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 = true can 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

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

settlement_token_id

integer | null

required

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

Response

Settlement token updated successfully

success

boolean

Example:

true

message

string

Example:

"Settlement token updated successfully"

settlement_token

object | null

Show child attributes

updated_at

integer

Overview

API

Merchant

Tokens

Commerce

Payor

WebSockets

Webhooks

Update stable settlement token selection

Body

Response