Skip to main content
POST
Top up a card (USDT debit from partner balance)

Authorizations

Authorization
string
header
required

Access token from POST /auth/v1/partner/token

Body

application/json
card_id
string
required
Example:

"00112233445566778899aabb"

amount_usdt
string
required

Decimal amount as a string, not a JSON number.

Pattern: ^-?\d+(\.\d+)?$
ext_id
string
required

Partner-side idempotency key (unique per partner)

Required string length: 1 - 128
Example:

"card-issue-20260710-003"

Response

Topup accepted

ext_id
string

Partner-side idempotency key (unique per partner)

Required string length: 1 - 128
Example:

"card-issue-20260710-003"

topup_id
string
card_id
string
amount
string

Decimal amount as a string, not a JSON number.

Pattern: ^-?\d+(\.\d+)?$
fee
string

Decimal amount as a string, not a JSON number.

Pattern: ^-?\d+(\.\d+)?$
status
string
Example:

"accepted"