Card Topup Status Notification

This API is used to notify card top up status

  • URL (Set in the management system)

  • 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

card_id

string

YES

Card id; Get from "Create Account"

transaction_id

string

YES

Unique transaction id

transaction_hash

string

Optional

Unique crypto currency transaction hash

status

number

YES

1: success; 2: fail;

fail_reason

number

Optional

1: Top-up amount was less than the minimum top-up; 2: Received but halted, amount exceeded maximum allowed per transaction; 3: Received but halted, balance with top-up amount would exceed card balance limit

sign

string

YES

sign: MD5(api_key+timestamp+secret+request_id) lowercase hex

  • Example

    {
      api_key: 'fd01a53d7834b06c080cd1024ae9c60a',
      request_id: '0f817ab66154454fadeea20ae2bfecc2',
      timestamp: '1682075328711',
      card_id: '300ff6a8122c4f0498fee1b59e9970e9',
      transaction_id: 'bc029d754cdb410e986c2a69af22ee68',
      transaction_hash: '133b553eb0b98a77afb059a4c95f62a35273c98e5c86051c1f41e4d3243831a8', 
      status: 1,
      sign: '786b0623ead8c40049265e03497af503'
    }

    signature example:MD5(fd01a53d7834b06c080cd1024ae9c60a168207532871116388ce4331b35e8e0d32777ba57d7d90f817ab66154454fadeea20ae2bfecc2)

  • Response

    {
      "code": 10200,
      "msg": "ok"
    }

Last updated