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.

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., EUR;
currencyExchangeRatestringExchange rate for fiat currency
cryptoCurrencyExchangeRatestringExchange rate for digital currency
orderTimestringOrder time
failReasonstringFailure reason
statusstringSUCCESS: Success
FAIL: Fail (User paid and fail)
CANCEL: Cancel (User did not pay and overtime)
shippingInfostringUser shipping information including:
address, city, country, firstName, lastName, phoneCountryCode, phoneNumber, roomNumber, state

Return Example

{
    "applyFee": "26.63285",
    "cardAmount": "0",
    "cardCurrency": "EUR",
    "cardId": "pre1002171381234501427",
    "cardNumber": "",
    "cardType": "2",
    "cryptoAddress": "0x9d5086adc54bb11234567ca9b694ca3a7",
    "cryptoCurrency": "USDT",
    "cryptoCurrencyExchangeRate": "1",
    "currencyExchangeRate": "1.065314",
    "deliveryFee": "0",
    "email": "18********[email protected]",
    "failReason": "",
    "network": "BSC",
    "orderAmount": "26.64",
    "orderNo": "10021234567427",
    "orderTime": "2024-04-23 18:53:41",
    "orderType": "1",
    "paymentAmount": "26.64",
    "rechargeFee": "0",
    "rechargeMarkup": "0",
    "shippingInfo": {
        "address": "7-3, Block X, XXXX 2C, XXXXXXXXX Road, XXXXXXXX District, Beijing City.",
        "city": "beijing",
        "country": "CN",
        "firstName": "XXXXXXXI",
        "lastName": "XXXXXXX",
        "phoneCountryCode": "86",
        "phoneNumber": "18123456782",
        "roomNumber": "7-3",
        "state": "beijingshi"
    },
    "status": "SUCCESS",
    "voucherCode": ""
}

Note

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