代收订单创建 (Pay-in Create)

接口描述

商户调用此接口发起一笔代收（支付）请求，平台创建订单并返回收银台收单链接（payUrl）。

---

请求信息

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

---

请求头（HTTP Headers）

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

---

请求 Body 参数

参数名称	必选	类型	示例值	描述
timestamp	是	Long	1772880000000	毫秒级时间戳
merchantOrderNo	是	String	202603070001	商户订单号（商户系统内唯一）
amount	是	String	220.00	交易金额，最多保留两位小数
payType	是	String	BKASH	支付通道类型，固定值：BKASH
notifyUrl	是	String	https://api.merchant.com/payin/notify	异步通知回调地址
name	否	String	Rahim Uddin	客户姓名
mobile	否	String	01712345678	手机号，以 01 开头的 10/11 位数字
email	否	String	user@example.com	邮箱地址
remark	否	String	Test Order	备注信息（回调时会原样回传）

请求示例

{
  "timestamp": 1772880000000,
  "merchantOrderNo": "202603070001",
  "amount": "220.00",
  "payType": "BKASH",
  "notifyUrl": "https://api.merchant.com/payin/notify",
  "name": "Rahim Uddin",
  "mobile": "01712345678",
  "email": "user@example.com",
  "remark": "Test Order"
}

---

响应参数

成功响应示例

{
  "code": 1,
  "msg": "success",
  "data": {
    "merchantNo": "M1639466186292",
    "merchantOrderNo": "202603070001",
    "platOrderNo": "876324486452871168",
    "amount": "220.00",
    "fee": "0",
    "payUrl": "https://gateway.example.com/checkout/876324486452871168",
    "expireTime": "2026-05-05 11:11:11",
    "status": "1"
  }
}

失败响应示例

{
  "code": 0,
  "msg": "param merchant error"
}

返回字段说明

字段名	类型	说明
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.payUrl	String	收银台支付跳转链接
data.expireTime	String	订单支付过期时间（格式：yyyy-MM-dd HH:mm:ss）
data.status	String	订单状态： 0: 已创建 1: 过期 2: 失败 3: 成功