Webhook for Order Accumulation Mode Payment

Introduction

Webhook for order accumulation mode payment.

When an accumulated order payment is successful but the total order amount is not yet met, the merchant will be notified.

👍

After the payment is completed, the relevant payment results and user information will be sent to the merchant in JSON format. The merchant needs to receive and process them, and respond according to the documentation specifications.

• The merchant must be able to handle duplicate notifications correctly or the same notification may be sent to the merchant multiple times.
• 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, the merchant 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.

🚧

The merchant system 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

Parameter	Sign	Type	Length	Description
allPayCryptoVolume	Yes	string	16	Total amount of all paid cryptocurrencies
hash	Yes	string	256	Transaction hash value
merchantOrderNo	Yes	string	64	Merchant order number
orderCryptoVolume	Yes	string	16	Total cryptocurrency amount for the order
orderNo	Yes	string	64	Order number
payCryptoCurrency	Yes	string	32	Cryptocurrency used for payment
payCryptoNetwork	Yes	string	32	Network of the cryptocurrency
payCryptoVolume	Yes	string	16	Amount of cryptocurrency paid
payNo	Yes	string	64	Payment number
payTime	Yes	string	64	Payment time (UTC+8, format: yyyy-MM-dd HH:mm:ss)
remainingCryptoVolume	Yes	string	16	Remaining unpaid cryptocurrency amount
status	Yes	string	32	Payment status
sign	No	string	256	Signature

Webhook Example

JSON

{  
    "allPayCryptoVolume": "0.6",  
    "hash": "0x756c76d322e743badb5f69eb06c4fb60db3357f2c3b16b7a2cb0f1ba16eba836",  
    "merchantOrderNo": "54674542786",  
    "orderCryptoVolume": "1",  
    "orderNo": "300217551599896101208",  
    "payCryptoCurrency": "USDT",  
    "payCryptoNetwork": "BSC",  
    "payCryptoVolume": "0.2",  
    "payNo": "300317551599924731312",  
    "payTime": "2025-08-14 16:29:56",  
    "remainingCryptoVolume": "0.4",  
    "sign": "247342F9678BA59ECE15B7027298E04E0FDEFFF5F2FA5CEC70003F774429DF23D438E5C599A7D72CAAF03F38EB8AB70A21AFDBBB447EB9476A41DAB94258A4D5",  
    "status": "pending"  
}