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

Parameter

Type

Description

orderNo

string

Order number

email

string

User's email

cardNumber

string

Card number

cardId

string

Card ID

cryptoAddress

string

Crypto wallet address

network

string

Network

orderType

string

1: Create card 2: Recharge

cardType

string

1: Virtual card 2: Physical card

orderAmount

string

Token order amount(count as USDT)

paymentAmount

string

User token payment(count as USDT)

cryptoCurrency

string

Digital currency type e.g., USDT; BTC; ETH

applyFee

string

Total card application fee in USDT

rechargeFee

string

Card recharge fee in USDT

voucherCode

string

Voucher code (returns empty if not used)

rechargeMarkup

string

Merchant recharge fee commission in USDT

deliveryFee

string

Delivery fee in USDT

cardAmount

string

Card amount, corresponding to card fiat currency

cardCurrency

string

Card currency e.g., USD

currencyExchangeRate

string

Exchange rate for fiat currency

cryptoCurrencyExchangeRate

string

Exchange rate for digital currency

orderTime

string

Order time

failReason

string

Failure reason

status

string

SUCCESS: Success
FAIL: Fail (User pay and failed)
CANCEL: Cancel (User did not pay and overtime)

Return Example

{
    "applyFee": "0",
    "cardAmount": "55",
    "cardCurrency": "EUR",
    "cardId": "1232330814012345678",
    "cardNumber": "5554748800912345",
    "cardType": "2",
    "cryptoAddress": "",
    "cryptoCurrency": "USDT",
    "cryptoCurrencyExchangeRate": "1",
    "currencyExchangeRate": "1.092759",
    "deliveryFee": "0",
    "email": "[email protected]",
    "failReason": "",
    "network": "TRX",
    "orderAmount": "61.91",
    "orderNo": "100217231874691123456",
    "orderTime": "2024-08-09 15:11:09",
    "orderType": "2",
    "paymentAmount": "61.91",
    "rechargeFee": "0.72122094",
    "rechargeMarkup": "0.99",
    "status": "SUCCESS",
    "voucherCode": ""
}

Note

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