跳转至

代付订单回调

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

回调规则

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

业务参数

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

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

字段 类型 说明
order_no string 平台订单号,格式为 MPO...
mch_order_no string 商户订单号
amount string 代付金额
fee string 手续费
status int 2 成功,3 失败
utr string 可选,印度 UTR;无值时不返回该字段

成功回调示例:

{
  "order_no": "MPO223456789",
  "mch_order_no": "PO202607010001",
  "amount": "500.00",
  "fee": "5.00",
  "status": 2,
  "utr": "UTR123456789"
}

失败回调示例:

{
  "order_no": "MPO223456789",
  "mch_order_no": "PO202607010001",
  "amount": "500.00",
  "fee": "5.00",
  "status": 3
}

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

响应要求

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

success

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