Get Topup Status

This API is used to get the status of a card top up record based on the unique transaction id.

• Path: /api/v1/mastercardService/virtualCard/getTopupTransaction

• Method: POST

• Content-Type

  application/json

• Headers

Key	Type	Required	Comments
authorization	string	YES	Authorization Header

• Body

Key	Type	Required	Comments
api_key	string	YES	api key
request_id	string	YES	Unique id; the shortest is 20 characters, the longest is 64 characters
timestamp	string	YES	13-digit; Valid for plus or minus 30 seconds
username	string	YES	Unique username of the account.
kit_number	string	YES	Show on card
transaction_id	string	NO	Unique transaction id; the shortest is 20 characters, the longest is 64 characters; Required if transaction_hash not set
transaction_hash	string	NO	Unique on-chain transaction hash; Required if transaction_id not set
sign	string	YES	sign: MD5(api_key+username+timestamp+secret+request_id)lowercase hex

• Example

  {
    api_key: 'ac97c403062e94a094131aa332df6458',
    request_id: '4a72be58c71d49ebaaaab8a7894c8e1e',
    timestamp: '1722238541353',
    username: 'frfrfr',
    kit_number: '2000001785317853',
    transaction_id: 'e25ff5a4f219456ab79504dafb480dbb',
    transaction_hash: '53a49700738721ed4f3dd49b324f350b2f1e417b4b1c6b2dc96d9bff55dc6691',
    sign: '7a9db29e07f205be4c07e0a07ef6e736'
  }

  signature example:MD5(ac97c403062e94a094131aa332df6458frfrfr1722238541353a446b6660552582e08b043b84634e1fe4a72be58c71d49ebaaaab8a7894c8e1e)

• Response

Key	Type	Comments
code	number	Response code
msg	string	Response message
data	object	details

details

Key	Type	Comments
amount	string	topup amount
status	number	topup receive status. 1 success； 2 fail
token_type	string	token type USDT、USDC
card_status	number	topup card status 1 pending 2success 3fail
top_up_method	number	topup method；3Blockchain Direct、5FEB API topup
token_amount	string	token amount
time	number	FEB system entry time
transaction_id	string	Unique on-chain transaction id
transaction_hash	string	Unique on-chain transaction hash

• Example

  {
    "code": 10200,
    "msg": "ok",
    "data": {
      "amount": '48.29',
      "status": 1,
      "token_type": 'USDT',
      "card_status": 1,
      "top_up_method": 3,
      "token_amount": '50',
      "time": 1721901242605,
      "transaction_id": 'e25ff5a4f219456ab79504dafb480dbb',
      "transaction_hash": '53a49700738721ed4f3dd49b324f350b2f1e417b4b1c6b2dc96d9bff55dc6691'
    }
  }