代付异步通知回调 (Payout Notification)

接口描述

代付订单出款确认成功或失败之后，平台将通过 HTTP POST 请求向商户提交订单时指定的 notifyUrl 发送异步状态通知。

IMPORTANT

1. 商户系统在接收到回调报文并成功处理业务后，必须返回纯文本字符串 SUCCESS。
2. 若商户系统未响应 SUCCESS，平台将启动自动重推机制：每隔 1 分钟推送一次，共推送 5 次。
3. 极特殊场景说明：在极少数金融网络异常情况下，可能存在“先回调成功，随后因银行拒付而退款失败”的反向冲正情况，商户端处理需做好幂等和异常处理准备。
4. 验签时使用平台提供的公钥，并忽略字母大小写差异。

---

请求信息

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

---

请求头（HTTP Headers）

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

---

回调 Body 参数

请求示例

{
  "timestamp": "1772880400000",
  "merchantOrderNo": "PO202603070001",
  "platOrderNo": "876324486452871168",
  "amount": "100.00",
  "fee": "5.00",
  "status": "3",
  "msg": "success",
  "remark": "Salary Payout",
  "payTime": "2026-09-09 22:22:22",
  "payAccountNo": "01666777888",
  "trxId": "SDIIFKISDL"
}

字段详细说明

字段名	必选	类型	示例值	说明
timestamp	是	String	1772880400000	回调通知的时间戳
merchantOrderNo	是	String	PO202603070001	对应的商户订单号
platOrderNo	是	String	876324486452871168	平台内部出款流水号
amount	是	String	100.00	订单出款金额
fee	是	String	5.00	出款手续费
msg	是	String	success	响应状态文字描述
status	是	String	3	代付订单状态： 0: 已创建 1: 支付中 / 处理中 2: 支付失败 3: 支付成功
remark	是	String	Salary Payout	商户下单时传给平台的备注信息（原样回传）
payTime	否	String	2026-09-09 22:22:22	付款时间（格式：yyyy-MM-dd HH:mm:ss）
payAccountNo	否	String	01666777888	付款账户
trxId	否	String	SDIIFKISDL	由电子钱包系统生成的唯一交易标识，用于标识本次交易

---

商户端响应要求

商户业务系统处理完成后，需在 HTTP 响应中直接输出：

SUCCESS