Sign in

v1

latestOpenAPI 3.0.02026-08-06112728.7 KB
Card

Top up organization card

Requires card.create permission.

post/top-up

Headers

Datestring

GMT server time, e.g. Tue, 21 Jan 2025 12:00:00 GMT. Required for every request.

Authorizationstring

HMAC-SHA256 Signature header. See the Authentication guide.

Digeststring

SHA-256 digest of the request body when a body is present.

Request body

idstring required

Internal ORGANIZATION_CARD primary key id.

amountstring required

Operation amount.

token_typestring required

Token type, for example USDT or USDC.

notestring

Optional note.

Example request

{
  "id": "a441831c-a5c7-4bed-8f61-793738afd5bc",
  "amount": "50.00",
  "token_type": "USDT",
  "note": "Top up for campaign budget"
}

Response

Standard response envelope

codeinteger required

Business code. 0 means success.

messagestring required

Response message.

Example response

{
  "data": {
    "tx_id": "tx_123",
    "card_balance": "150.25"
  }
}