Webhook for Orders

Brief Description

Order notification webhook configuration and usage

  • Please contact the staff to configure your Webhook Endpoint Url. The Url must be HTTPS.
  • When the order status changes, corresponding order messages will be pushed to your Webhook Endpoint Url.
  • Upon receiving the Webhook message, if you return HTTP CODE 200, it means you have successfully received it.
  • The notification frequency is once every 10 minutes for the first hour, then once every hour, for a total of 24 hours.

Explanation of Return Parameters

ParameterTypeDescription
orderNostringOrder number
emailstringEmail
cardNumberstringCard number
cardIdstringCard ID
cryptoAddressstringCrypto wallet address
networkstringNetwork
orderTypestring1: Create card 2: Recharge
cardTypestring1: Virtual card 2: Physical card
orderAmountstringToken order amount(count as USDT)
paymentAmountstringUser token payment(count as USDT)
cryptoCurrencystringDigital currency type e.g., USDT; BTC; ETH
applyFeestringTotal card application fee in USDT
rechargeFeestringCard recharge fee in USDT
voucherCodestringVoucher code (returns empty if not used)
rechargeMarkupstringMerchant recharge fee commission in USDT
deliveryFeestringDelivery fee in USDT
cardAmountstringCard amount, corresponding to card fiat currency
cardCurrencystringCard currency e.g., USD
currencyExchangeRatestringExchange rate for fiat currency
cryptoCurrencyExchangeRatestringExchange rate for digital currency
orderTimestringOrder time
failReasonstringFailure reason
statusstringSUCCESS: Success
FAIL: Fail (User pay and failed)
CANCEL: Cancel (User did not pay and overtime)

Return Example

{  
  "email":"[[email protected]](mailto:[email protected])",  
  "cardNumber":"5567665457839662",  
  "cardId":"c_52b6365f752c4bc480ef",  
  "cryptoAddress":"TWU5feBTJDnjddZwuiJEDvyB4XCNmMfHAd",  
  "network":"BSC",  
  "orderNo":"100216928821071960014",  
  "orderType":"1",  
  "cardType":"1",  
  "status":"SUCCESS",  
  "voucherCode":"",  
  "failReason":"SUCCESS",  
  "orderAmount":"100",  
  "paymentAmount":"100",  
  "cryptoCurrency":"USDT",  
  "applyFee":"SUCCESS",  
  "rechargeFee":"3",  
  "rechargeMarkup":"1",  
  "deliveryFee":"1",  
  "cardAmount":"95",  
  "cardCurrency":"USD",  
  "currencyExchangeRate":"1",  
  "cryptoCurrencyExchangeRate":"1",  
  "orderTime":"2023-08-24 21:01:54"  
}

Note

For more error codes, please refer to the error code description on the homepage.