代收异步通知回调 (Pay-in Notification)

接口描述

代收订单支付确认成功或失败后，平台将通过 HTTP POST 请求异步推送订单最终状态至商户在下单时传入的 notifyUrl。

IMPORTANT

1. 商户系统在接收到回调报文并成功处理业务后，必须直接向 HTTP 响应流中输出纯文本字符串 SUCCESS（不带引号和换行）。
2. 若商户系统返回非 SUCCESS 或响应超时，平台将触发重试机制：最多重试 5 次，重试间隔时长为 20 分钟。
3. 进行验签时，请使用平台提供的公钥，并忽略字母大小写差异。

---

请求信息

• 请求 URL：商户在代收下单接口中传入的 notifyUrl
• 请求方式：POST
• Content-Type：application/json; charset=utf-8

---

请求头（HTTP Headers）

参数名	必填	类型	说明
merchantNo	是	String	商户号
sign	是	String	平台使用自身私钥对请求 Body 内容生成的 RSA 签名

---

回调 Body 参数

请求示例

{
  "timestamp": "1772880120000",
  "merchantOrderNo": "202603070001",
  "platOrderNo": "876324486452871168",
  "amount": "100.00",
  "fee": "2.00",
  "status": "3",
  "msg": "success",
  "remark": "Test Order"
}

字段详细说明

字段名	必选	类型	示例值	说明
timestamp	是	String	1772880120000	回调发送的时间戳
merchantOrderNo	是	String	202603070001	对应的商户订单号
platOrderNo	是	String	876324486452871168	平台内部订单流水号
amount	是	String	100.00	订单实际交易金额
fee	是	String	2.00	交易手续费
msg	是	String	success	状态描述说明
status	是	String	3	订单状态： 0: 已创建 1: 过期 2: 支付失败 3: 支付成功
remark	否	String	Test Order	商户下单时传给平台的备注（原样回传）

---

商户端响应要求

商户处理完本地订单状态及业务逻辑后，需在 HTTP Response Body 中返回纯文本：

SUCCESS