代收通知回调
当订单成功或失败后,平台将主动向商户在创建订单时传入的 notifyUrl 发送异步通知。
回调规范
- 请求地址: 商户创建订单时提交的
notifyUrl - 请求方法:
POST - Content-Type:
application/json; charset=utf-8 - 重试策略: 商户系统收到通知并校验无误后,必须返回
SUCCESS(不区分大小写,或者返回 HTTP 200)。如果平台未收到成功响应,将会每隔 20 分钟重新尝试推送,最多重试 5 次。
请求 Header 参数
| 参数名 | 必填 | 类型 | 说明 |
|---|---|---|---|
| merchantNo | 是 | string | 商户号 |
| sign | 是 | string | 平台的签名,商户需使用平台公钥进行验签(参见全局说明) |
请求 Body 参数示例
json
{
"timestamp": "1639466186292",
"merchantOrderNo": "ORDER_123456789",
"platOrderNo": "876324486452871168",
"amount": "100.00",
"fee": "1.00",
"status": "3",
"msg": "success",
"remark": "custom_data"
}请求 Body 参数说明
| 字段名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| timestamp | 是 | string | 时间戳 |
| merchantOrderNo | 是 | string | 商户订单号 |
| platOrderNo | 是 | string | 平台订单号 |
| amount | 是 | string | 订单金额 |
| fee | 是 | string | 手续费 |
| msg | 是 | string | 响应消息说明 |
| status | 是 | string | 状态:0 订单初始化,1 支付中,2 支付失败,3 支付成功 |
| remark | 是 | string | 创建订单时商户传入的备注(原样回传) |
