Introduction

You can receive all payment status updates directly on your server without needing to repeatedly query the order status when using the NFT checkout API mode.
Upon receiving the webhook, merchants must return a success response; otherwise, the system will retry the callback every 5 minutes, up to a total of 3 attempts.
Merchants are required to verify the signature of the webhook parameters.
Construct the sign string by connect all webhook parameters (excluding "signature") in order, and sign it using HmacSHA1 with the appSecret. For more details, please refer to the Authentication page.

API Description

Request Method: POST

Content-Type: application/json

Request Path: merchant defined API

NFT Webhook Example

{
    "amount": "888",
    "fiat": "USD",
    "orderNo": "994864610797428736",
    "payTime": "2022-07-08 15:18:43",
    "payType": "CREDIT_CARD",
    "type": "MARKET/MINT",
    "name":"NFT name",
    "quantity": "1", //NFT quantity
    "uniqueId":"#10001", // NFT Unique Identity ，MARKET
    "appId": "3sst5rng5cf1n1ei",
    "merchantOrderNo":"10000001",
    "message": "",
    "status": "PAY_SUCCESS" //PAY_FAIL/pay fail,NEW/waiting for payment,PAY_SUCCESS/payment success,TIMEOUT/order timeout
    "signature":"4f26f5b74f787b37e4957cd4d7cb5d49bec3be0e"//sign for the verification refer Sign demo for Page integration
}

Payment status

Element	Remarks
NEW	new order
PAY_SUCCESS	fiat payment succeed
PAY_FAIL	fiat payment fail
TIME_OUT	time out