Skip to content

代付通知回调

在代付确认成功或者失败之后,平台将主动向商户在创建代付订单时传入的 notifyUrl 发送异步通知。


回调规范

  • 请求地址: 商户创建订单时提交的 notifyUrl
  • 请求方法: POST
  • Content-Type: application/json; charset=utf-8
  • 重试策略: 商户系统收到通知并校验无误后,必须返回 SUCCESS(不区分大小写,或者返回 HTTP 200)。如果平台未收到成功响应,将会每隔 1 分钟重新推送,共推送 5 次。 (注:极少数情况下可能会出现先成功后退款(转为失败)的情况。)

请求 Header 参数

参数名必填类型说明
merchantNostring商户号
signstring平台的签名,商户需使用平台公钥进行验签(参见全局说明)

请求 Body 参数示例

json
{
  "timestamp": "1639466186292",
  "merchantOrderNo": "ORDER_123456789",
  "platOrderNo": "876324486452871168",
  "amount": "100.00",
  "fee": "1.00",
  "status": "3",
  "msg": "success",
  "remark": "custom_data"
}

请求 Body 参数说明

字段名必选类型说明
timestampstring时间戳
merchantOrderNostring商户订单号
platOrderNostring平台订单号
amountstring代付金额
feestring手续费
msgstring响应消息说明
statusstring状态:0 订单初始化,1 处理中,2 支付失败,3 支付成功
remarkstring创建订单时商户传入的备注(原样回传)