Skip to main content
GET
/
api
/
v1
/
merchant
/
settlement-preference
Get current settlement preference and stable token options
curl --request GET \
  --url https://api-beta.pepay.io/api/v1/merchant/settlement-preference \
  --header 'Authorization: Bearer <token>'
{
  "settlement_preference": "stables_preferred",
  "description": "Prefer stable coins when available, fallback to original token",
  "selected_settlement_token": {
    "id": 5,
    "token_symbol": "USDC",
    "token_name": "USD Coin",
    "network": "ethereum",
    "token_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "token_decimals": 6,
    "photo_uri": "<string>",
    "is_default": false
  },
  "available_stable_tokens": [
    {
      "id": 5,
      "token_symbol": "USDC",
      "token_name": "USD Coin",
      "network": "ethereum",
      "token_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "token_decimals": 6,
      "photo_uri": "<string>",
      "is_default_settlement": false
    }
  ],
  "updated_at": 123
}

Authorizations

​
Authorization
string
header
required

JWT token for wallet authentication

Response

Settlement preferences and token options retrieved successfully

​
settlement_preference
enum<string>

Current settlement preference

Available options:
stables_only,
stables_preferred,
tokens
Example:

"stables_preferred"

​
description
string

Human-readable description of the current setting

Example:

"Prefer stable coins when available, fallback to original token"

​
selected_settlement_token
object

Currently selected stable settlement token (or default)

​
available_stable_tokens
object[]

All available stable settlement tokens for selection

​
updated_at
integer

Last time preferences were updated (epoch seconds).