创建孟加拉代收订单
创建孟加拉 BKASH 或 NAGAD 代收订单,并返回收银台地址。
接口信息
- 方法:
POST - 路径:
/v2/pay_in - 认证:商户接口签名规则
业务参数
以下 JSON 编码后放入签名请求的 data 字段。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
mch_order_no |
string | 是 | 商户订单号,不能为空 |
amount |
string | 是 | 订单金额,使用十进制字符串 |
user_id |
string | 是 | 商户侧用户 ID,不能为空 |
mode |
int | 否 | 1 收银台(默认) |
notify_url |
string | 否 | 异步通知 URL,推荐传入;如未传则不会发起回调请求 |
return_url |
string | 否 | 支付完成后的返回 URL |
data |
object | 是 | 支付方式信息 |
data.type |
string | 是 | bangladesh_bkash 或 bangladesh_nagad |
BKASH 示例:
{
"mch_order_no": "PI202607010002",
"amount": "1000.00",
"user_id": "USER10002",
"mode": 1,
"notify_url": "https://merchant.example.com/notify/pay-in",
"return_url": "https://merchant.example.com/payment/result",
"data": {
"type": "bangladesh_bkash"
}
}
NAGAD 与 BKASH 的请求结构相同,将 data.type 改为 bangladesh_nagad 即可。
成功响应
兼容性说明:后续可能新增其他响应字段。接入方应忽略未识别字段,不要因出现文档外字段而解析失败。
{
"code": 0,
"message": "ok",
"data": {
"order_no": "MPI123456790",
"amount": "1000.00",
"type": "cashier",
"url": "https://cashier.example.com/pay_in/cashier/MPI123456790"
}
}
非生产环境的响应还可能包含 test_callback_url,可根据该地址回调;生产环境不会返回该字段。