代付校检接口 (Merchant Payout Verification API)

接口描述

为了保障商户出款资金的极高安全性，平台支持在执行代付订单付款出款前，主动发起 HTTP POST 请求回调商户系统配置的“代付校验接口”，进行订单二次确认。

IMPORTANT

• 校验成功：商户系统收到校验请求并核验无误后，返回纯文本 true 或 JSON 中的确认标志，平台随即进入正式出款流程；
• 校验失败：若商户系统返回 false，平台将判定该笔代付校验失败并立即终止出款，原路退回预冻结的代付本金及手续费；
• 异常处理：若请求商户校验接口发生网络超时或 HTTP 错误（如 500），平台默认视为校验失败；
• 开通方式：开通此二次校验功能需商户主动联系平台技术对接人员，在后台配置商户的校验接口地址。
• 验签请使用平台提供的公钥，并忽略字母大小写差异。

---

请求信息

• 请求 URL：商户在平台侧配置的校验回调 URL
• 请求方式：POST
• Content-Type：application/json; charset=utf-8

---

请求头（HTTP Headers）

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

---

请求 Body 参数

请求示例

{
  "timestamp": "1772880700000",
  "merchantOrderNo": "PO202603070001",
  "platOrderNo": "876324486452871168",
  "amount": "100.00",
  "bankCode": "BAC",
  "accountNo": "01812345678",
  "accountName": "Tanvir Ahmed"
}

请求字段说明

字段名	必选	类型	示例值	说明
timestamp	是	String	1772880700000	毫秒级时间戳
merchantOrderNo	是	String	PO202603070001	商户订单号
platOrderNo	是	String	876324486452871168	平台内部订单流水号
amount	是	String	100.00	出款金额
bankCode	是	String	BAC	银行或钱包代码（例如：BAC、BKASH、NAGAD 等）
accountNo	是	String	01812345678	收款银行账户或钱包账号
accountName	是	String	Tanvir Ahmed	银行或电子钱包开户收款人姓名

---

商户端响应要求

商户系统完成本地订单一致性及风控核验后，直接在 HTTP Response Body 中返回纯文本（小写字符串）：

true

或校验不通过时返回：

false