订单回调

提示

代收订单成功或失败后，系统会自动向订单关联的回调地址（notify_url）发送通知消息，告知该笔订单最新状态。

通知地址

POST notify_url（商户在创建订单接口中指定）

数据提交

使用 POST 的方式 。相关请求头的 Content-Type 字段为：

application/json

为保障接口安全，系统端会对通知参数进行数字签名，签名结果放入请求头 Signature 中，商户请务必验证签名防⽌数据泄漏导致出现“假通知”。

通知参数

参数名	必填	类型	说明
merch_sn	Y	string	商户 merch_sn
timestamp	Y	string	当前UNIX时间戳(单位：秒)
order_id	Y	string	商户订单号
trade_id	Y	string	平台订单号
amount	Y	string	订单金额
fee	Y	string	手续费金额，订单不成功时为0
status	Y	string	订单状态, success: 成功, failed: 失败 awaiting: 待支付, pending: 创建中 processing: 待处理 refund: 已退款
attach	Y	string	商户自定义数据，回调时原路返回

通知示例

{
    "merch_sn": "6BxTE9yM0Y",
    "timestamp": "1729167195",
    "order_id": "cc598c140534417e8d1250bf210d0820",
    "trade_id": "1846888096142987264", 
    "amount": "2390.4", 
    "fee": "47.81",
    "status": "success",
    "attach": "useridxxx"
}

通知返回

商户系统接收到代收结果后，需要返回Http Status取值区间为 [200,300) 的响应，以证明收到通知。
商户在收到通知后，需要在响应体 body 中返回ok或者OK，告知系统已收到回调通知，否则会触发系统的通知重试机制。

通知重试

如果商户5秒未应答或系统没有收到ok或者OK，则触发重试机制，系统最多会重试通知6次。

重试间隔时间分别为5分钟，30分钟，1小时，2小时，6小时，12小时。