INinfini
Card

Top up organization card

Changed on

Requires card.create permission.

post/top-up

Request

Headers

X-API-Key-IDstring required

32-character Base58 credential ID returned after public-key registration.

X-API-Timestampstring required

Unix timestamp in seconds; tolerance is ±300 seconds.

X-API-Noncestring required

16 cryptographically random bytes encoded as unpadded Base64URL; fresh on every attempt.

Digeststring required

SHA-256= followed by standard padded Base64 of SHA-256 of exact request body bytes. Required even for an empty body; included in the signing string.

Authorizationstring required

Use Ed25519 signature="BASE64_SIGNATURE", where BASE64_SIGNATURE is the standard padded Base64 signature. See /docs/en/4-authorization for the exact signing string.

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"
  }
}

Changes

  • 9195be46202fRevision changes
    • breaking

      added the new required header request parameter X-API-Key-ID

    • breaking

      added the new required header request parameter X-API-Nonce

    • breaking

      added the new required header request parameter X-API-Timestamp

    • breaking

      the header request parameter Authorization became required

    • breaking

      the header request parameter Digest became required

    • warning

      deleted the header request parameter Date

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status