代付订单创建 (Payout Create)

接口描述

商户调用此接口发起单笔代付（出款）请求。平台扣减商户账户余额并将款项转入指定的收款账户（如 BKASH 个人电子钱包）。

---

请求信息

• 请求 URL：/payout/create
• 请求方式：POST
• Content-Type：application/json; charset=utf-8

---

请求头（HTTP Headers）

参数名	必填	类型	说明
merchantNo	是	String	商户号
sign	是	String	请求 Body 的 RSA 签名

---

请求 Body 参数

参数名	必选	类型	示例值	说明
timestamp	是	Long	1772880300000	毫秒级时间戳
merchantOrderNo	是	String	PO202603070001	商户订单号（商户系统唯一）
amount	是	String	220.00	出款金额，最多保留两位小数
payType	是	String	BKASH	支付通道类型，固定值：BKASH
accountNo	是	String	01812345678	收款账户号（如 BKASH 钱包账号，以 01 开头的数字）
accountName	是	String	Tanvir Ahmed	收款人姓名
notifyUrl	是	String	https://api.merchant.com/payout/notify	异步通知回调地址
mobile	否	String	01812345678	收款人电话，格式为以 01 开头的 10/11 位数字
email	否	String	receiver@example.com	收款人邮箱
remark	否	String	Salary Payout	备注信息（回调时会原样回传）

请求示例

{
  "timestamp": 1772880300000,
  "merchantOrderNo": "PO202603070001",
  "amount": "220.00",
  "payType": "BKASH",
  "accountNo": "01812345678",
  "accountName": "Tanvir Ahmed",
  "notifyUrl": "https://api.merchant.com/payout/notify",
  "mobile": "01812345678",
  "email": "receiver@example.com",
  "remark": "Salary Payout"
}

---

响应参数

成功响应示例

{
  "code": 1,
  "msg": "ok",
  "data": {
    "merchantNo": "M1639466186292",
    "merchantOrderNo": "PO202603070001",
    "platOrderNo": "876324486452871168",
    "amount": "220.00",
    "fee": "5.00",
    "status": "0"
  }
}

失败响应示例

{
  "code": 0,
  "msg": "Insufficient balance"
}

返回参数说明

参数名	类型	说明
code	Integer / String	状态码：1 成功，0 失败
msg	String	消息说明
data	Object	业务响应数据（失败时可能为 null）
data.merchantNo	String	商户号
data.merchantOrderNo	String	商户订单号
data.platOrderNo	String	平台订单号
data.amount	String	出款金额
data.fee	String	代付手续费
data.status	String	订单状态： 0: 已创建 1: 支付中 / 处理中 2: 失败 3: 成功