🔔 订单异步通知
订单完成后,系统会自动向订单关联的回调地址(notify_url)发送通知消息,告知该笔订单的最终状态。
请求方法: POST
请求类型: application/json
请求参数:
字段名称 | 字段类型 | 是否必填 | 是否签名 | 说明 |
---|---|---|---|---|
appid |
string |
是 |
是 |
商户号 |
txid |
string |
是 |
是 |
链上交易hash值 |
plat_order_sn |
string |
是 |
是 |
平台订单号 |
order_sn |
string |
是 |
是 |
商户订单号 |
chain_type |
string |
是 |
是 |
链路: 1: 波场(TRC20) 2: 以太坊(ERC20) 3: PayPal(PYUSD) |
pay_usdt |
string |
是 |
是 |
金额,单位 USDT / PYUSD |
actual_usdt |
string |
是 |
是 |
订单实付金额,单位 USDT / PYUSD,同样金额时,可能出现金额调整 |
poundage |
string |
是 |
是 |
手续费,单位 USDT / PYUSD |
status |
string |
是 |
是 |
订单状态:订单状态 |
create_time |
string |
是 |
是 |
订单创建时间,Unix 秒级时间戳 |
success_time |
string |
是 |
是 |
订单完成时间,Unix 秒级时间戳 |
attach |
string |
否 |
否 |
用户自定义数据,在回调到 notify_url 的时候会原样返回 |
sign |
string |
是 |
是 |
数据签名,详见:签名算法 |
通知返回
商户在收到通知信息后,在响应体的 body 中输出 OK 或者 ok(php例子:echo "OK ";) ,否则会重复 5 次发送点对点通知。
重试规则如下:
如第一次通知失败,后续通知频率(秒):10,30,60,300,600 。
最后更新于