创建孟加拉代付订单
创建孟加拉 BKASH 或 NAGAD 钱包代付订单。
接口信息
- 方法:
POST - 路径:
/v2/pay_out - 认证:商户接口签名规则
业务参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
user_id |
string | 是 | 商户侧用户 ID,不能为空 |
mch_order_no |
string | 是 | 商户订单号,不能为空 |
amount |
string | 是 | 代付金额,使用十进制字符串 |
notify_url |
string | 否 | 异步通知 URL,推荐传入;如未传则不会发起回调请求 |
data |
object | 是 | 代付方式及收款钱包信息 |
data.method |
string | 是 | bangladesh_bkash 或 bangladesh_nagad |
data.account |
string | 是 | 收款钱包账号,至少 2 个字符 |
data.account_name |
string | 是 | 收款人姓名,至少 2 个字符 |
BKASH 示例:
{
"user_id": "USER10002",
"mch_order_no": "PO202607010002",
"amount": "1000.00",
"notify_url": "https://merchant.example.com/notify/pay-out",
"data": {
"method": "bangladesh_bkash",
"account": "01712345678",
"account_name": "Test User"
}
}
NAGAD 与 BKASH 的请求结构相同,将 data.method 改为 bangladesh_nagad 即可。
成功响应
兼容性说明:后续可能新增其他响应字段。接入方应忽略未识别字段,不要因出现文档外字段而解析失败。
{
"code": 0,
"message": "ok",
"data": {
"order_no": "MPO223456790",
"amount": "1000.00",
"fee": "10.00"
}
}
非生产环境的响应还可能包含 test_callback_url,可根据该地址回调成功或失败;生产环境不会返回该字段。