代收订单回调 - Pay247 Documents

通知URL

网关向创建订单时的 notify_url 发送 POST JSON。商户应验证 sign，按 mch_order_no 幂等处理，并返回纯文本 SUCCESS（忽略大小写和首尾空白）。其他响应会触发重试；查询接口可用于核对最终状态。回调体没有 pay_theme。

参数	是否出现	类型	说明
`mch_id`	始终	string	商户号，标识该订单所属商户
`mch_order_no`	始终	string	商户提交的订单号
`order_no`	始终	string	Pay247 生成的平台订单号
`status`	始终	string	订单状态；按实际状态处理，可能包含 SUCCESS、FAIL、CLOSED、UNDERPAID、OVERPAID
`currency`	始终	string	订单币种
`pay_method`	始终	string	实际支付方式代码
`amount`	始终	string	订单金额，以订单币种计
`fee`	始终	string	订单手续费，以订单币种计
`error`	始终	string	错误信息，可能为空
`created_at`	始终	integer	创建时间，毫秒时间戳
`paid_at`	条件性	integer	有支付时间时才返回
`actual_amount`	条件性	string	商户允许多付/少付或 v3.0 已支付状态时返回
`utr`	条件性	string	仅非 FAIL 的 INR 订单返回，值可能为空
`sign`	始终	string	回调签名

{
  "mch_id": "MCH12345678",
  "mch_order_no": "PAYIN-1001",
  "order_no": "PI202609280001",
  "status": "SUCCESS",
  "currency": "INR",
  "pay_method": "UPI",
  "amount": "99.11",
  "fee": "1.00",
  "error": "",
  "created_at": 1693233334134,
  "paid_at": 1693233344134,
  "actual_amount": "99.11",
  "utr": "123456789012",
  "sign": "<computed signature>"
}

通知回调响应结果

商户应返回 Content-Type: text/plain 的响应正文：

返回内容	处理结果
`SUCCESS`	确认通知，停止重试；大小写及前后空白不影响判断。
`FAIL` 或其他内容	视为未确认，网关按递增间隔重试。当前代收任务通常在 10、100、1000 秒后重试，最多尝试 4 次；最终状态仍应通过订单查询核对。