异步通知

提示

用户支付完成后，系统会自动向订单关联的回调地址（notify_url）发送通知消息，告知该笔订单已支付完成。

通知地址

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

通知参数

参数名	含义	类型	说明
appid	商户号	string(16)	商户 appid
order_id	商户订单号	string(64)	商户订单号
order_type	商户订单类型	int	商户订单类型 1:收款 2:代付
status	订单状态	int	1:等待支付 2:支付成功 3:支付超时 4:支付失败
block_transaction_id	交易hash	string(128)	区块链交易hash，商户可打开区块链浏览器查询交易详情
attach	商户自定义数据	string(64)	商户自定义数据，回调时原路返回
sign	签名串	string(32)	安全校验签名串

通知示例

{
    "appid": "23456719",
    "order_id": "ZGbqEadw1puEgDeU",
    "order_type": 1, 
    "status": 2,
    "block_transaction_id": "71f36f7c3eb073a24d0d3e49af6990928a2ae04764c06c07d414acd3f743ae9c",
    "attach": "userid9826341",
    "sign": "526517f4603f25ab9ab686c1730f17b5"
}

通知返回

商户在收到通知后，需要在响应体 body 中返回ok或者OK，告知系统已收到回调通知，否则会触发系统的通知重试机制。

通知重试

如果系统没有收到ok或者OK，则触发重试机制，重试规则如下：
间隔 30秒 会进行第1次重试。
如第一次重试仍为失败，后续通知频率（秒）为：120，300。

提示

商户也可在后台 订单详情 页面，手动触发 回调通知。