回调通知

代收订单回调

代收订单完成后，系统会向下单时提交的 callback_url 发送回调。

• 请求方法：POST
• 请求体：JSON

回调字段

字段	类型	说明
id	string	平台订单号
trans_id	string	商户订单号
mch_id	integer	商户号
order_amount	string	下单金额
payed_amount	string	实付金额
channel	string	通道代码
status	number	当前订单状态，通常 60 表示成功
created_at	string	创建时间
payed_at	string | null	支付时间，未成功时可能为 null
sign	string	MD5 签名

回调示例

{
  "id": "C202605040001",
  "trans_id": "ORDER-10001",
  "mch_id": 10001,
  "order_amount": "100.00",
  "payed_amount": "100.00",
  "channel": "bank",
  "status": 60,
  "created_at": "2026-05-04 10:05:00",
  "payed_at": "2026-05-04 10:06:10",
  "sign": "0c8d5a7bb4d9d0c1f4f8f5b0b749b8ad"
}

回调要求

• 成功接收后，请返回纯文本 success
• 平台等待回调响应的超时时间为 5 秒
• 首次回调失败后，会在 60 秒后自动重试 1 次
• 回调可能重复，请按 trans_id 或 id 做幂等处理
• 请务必校验 sign
• 请务必核对 payed_amount，不要只看 order_amount

代付订单回调

代付订单进入最终结果后，系统会向 callback_url 发送回调。

• 请求方法：POST
• 请求体：JSON

回调字段

字段	类型	说明
id	string	平台订单号
trans_id	string	商户订单号
mch_id	integer	商户号
order_amount	string	订单金额
status	number	订单状态，50 为取消，60 为成功
created_at	string	创建时间
payed_at	string	成功时返回
canceled_at	string	取消时返回
sign	string	MD5 签名

成功回调示例

{
  "id": "P202605040001",
  "trans_id": "WDL-10001",
  "mch_id": 10001,
  "order_amount": "100.00",
  "status": 60,
  "created_at": "2026-05-04 10:10:00",
  "payed_at": "2026-05-04 10:15:00",
  "sign": "6a8ad87c66164acb509b4a1fe2f832f4"
}

取消回调示例

{
  "id": "P202605040002",
  "trans_id": "WDL-10002",
  "mch_id": 10001,
  "order_amount": "100.00",
  "status": 50,
  "created_at": "2026-05-04 10:20:00",
  "canceled_at": "2026-05-04 10:23:00",
  "sign": "fc5c1bc2217f09027d7a83a1f7e1d6d7"
}

回调要求

• 成功接收后，请返回纯文本 success
• 平台等待回调响应的超时时间为 5 秒
• 首次回调失败后，会在 60 秒后自动重试 1 次
• 回调可能重复，请按 trans_id 或 id 做幂等处理
• 请务必校验 sign