Introduction

For decentralized platform partners integrating with the native API, you are required to provide a webhook to notify AEON upon on-chain fund transfer completion. AEON will then update the order status to either "success" or "fail" accordingly.

Description

• After the payment is completed, the relevant payment results and user information will be sent to AEON in JSON format.
• Merchant's HTTP response code need to be 200 or the response content include success, the notification will be successed. Subsequent notifications will be retried with the following frequency: every 2 minutes within 10 minutes of the order, every 10 minutes within 1 hour of the order, and every 1 hour within 12 hours of the order.
• When handling notifications, AEON should first check the status of the relevant business data to determine whether the notification has already been processed. If it has not been processed, continue processing; if it has been processed, return a successful response directly.
• Fields with values of null or "" are not included in the signature.
• AEON must verify the signature of the payment result notification and check whether the returned order amount matches the amount on the merchant side. This is to prevent "false notifications" caused by data leaks, which could lead to financial losses.

Webhook Parameters

Webhook Example

SUCCESS

{
        "merchantOrderNo": "21313131311123",
        "orderNo": "31313131311111",
        "status": "SUCCESS",
        "hash": "0X131313****",
        "usdAmount": "10.01",
        "amount": "10.01",
        "currency": "USDT",
        "network": "BSC",
        "rate": "1",
        "fromAddress": "0X1313***",
        "errorMsg": "",
        "createTime": "18713131666666",
        "sign": "B42DA144E9BD180F83E8E7EBD2A9F933798616819FF1BBE4AD4C84081073ECB85BD67F850D25303C5FD9CDF17FE82DD4DD0AAA44F9B7D6121EF17DE3428EFF1C"
}

Description of Order Status