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

Path Parameters

card_id
string
required
Example:

"00112233445566778899aabb"

Body

application/json
amount_usdt
string
required
Pattern: ^-?\d+(\.\d+)?$
Example:

"12.50"

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
Pattern: ^-?\d+(\.\d+)?$
Example:

"12.50"

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

"12.50"

status
string
Example:

"accepted"

request_id
string<uuid>

Correlation id for support