Async notification
Where this sits
When the order finishes, the system POSTs JSON to notifyUrl. Fulfill after verification and acknowledge the callback.POST
Merchant notifyUrlNotification fields
| Field | Type | Required | Sign | Example | Description |
|---|---|---|---|---|---|
appId | string | Yes | Yes | — | APP ID |
orderNo | string | Yes | Yes | — | Platform order no |
merchantOrderNo | string | Yes | Yes | — | Merchant order no |
network | string | Yes | Yes | — | Network, see Parameter lookup |
asset | string | Yes | Yes | USDC | Order asset; see Parameter lookup |
cryptoAmount | string | Yes | Yes | — | Order amount |
paidCryptoAmount | string | Yes | Yes | — | Paid amount |
fee | string | Yes | Yes | — | Fee |
paidFee | string | Yes | Yes | — | Paid fee |
status | string | Yes | Yes | — | Status; see Parameter lookup |
createdAt | string | Yes | Yes | — | Created at, Unix seconds |
completedAt | string | Yes | Yes | — | Completed at, Unix seconds |
attach | string | No | No | — | Attach |
signature | string | Yes | No | — | Signature |
Acknowledgement
After receiving a notification, the merchant MUST acknowledge the callback. Otherwise the notification is retried.
Retry schedule
If the first notify fails, retries follow 10, 60, 600 seconds — up to 3 additional attempts.