跳转至

代收订单回调

代收订单支付成功后,平台向创建订单时传入的 notify_url 发送回调。未传 notify_url 时不会发起回调请求。

回调规则

  • 方法:POST
  • 地址:创建代收订单时传入的 notify_url
  • 触发状态:代收成功
  • 签名:商户回调签名规则

业务参数

回调请求的 data 解码后包含以下 JSON:

兼容性说明:后续可能新增其他回调字段。接入方应忽略未识别字段,不要因出现文档外字段而拒绝处理回调。

字段 类型 说明
order_no string 平台订单号,格式为 MPI...
mch_order_no string 商户订单号
amount string 下单金额
actual_amount string 实际到账金额
fee string 手续费
status int 固定为 2,表示成功
{
  "order_no": "MPI123456789",
  "mch_order_no": "PI202607010001",
  "amount": "100.50",
  "actual_amount": "100.50",
  "fee": "1.50",
  "status": 2
}

代收回调业务字段与查询代收订单data 字段一致。

响应要求

商户处理成功后必须返回 HTTP 200 和纯文本:

success

其他响应会被视为失败,并触发平台重试。详细规则见商户回调签名规则