创建出款单(孟加拉)
创建孟加拉塔卡(BDT)出款订单接口。孟加拉代付为移动钱包(Nagad / bKash)转帐。
请求资讯
- 请求 URL:
/gateway/api/v2/payouts - 请求方式:
POST - Content-Type:
application/json;charset=utf-8
请求参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| platform_id | 是 | String(6) | 商户 ID |
| service_id | 是 | String(7) | 服务 ID,固定值 SVC0004 |
| payout_cl_id | 是 | String(64) | 商户订单号 |
| amount | 是 | Integer(10) | 金额(分) |
| notify_url | 否 | String(256) | 交易结果通知地址 |
| bank_name | 是 | String(45) | 钱包代码,NAGAD 或 BKASH,详见钱包列表 |
| name | 是 | String(2-64) | 受款人户名(至少 2 个字符) |
| number | 是 | String(5-64) | 受款人钱包帐号(手机号,至少 5 个字符) |
| currency | 是 | String(3) | 固定值:bdt |
| request_time | 是 | Integer(10) | 请求时间(秒) |
| sign_type | 否 | String(16) | 签名类型,固定值 HMAC-SHA256 |
| sign | 是 | String(32|64) | 订单签名 |
服务 ID
SVC0004钱包代付(Nagad / bKash)
钱包代码
bank_name 仅支援 NAGAD、BKASH(大小写不敏感)。rocket、upay 暂不支援——注意:传入不支援的钱包时,建单接口仍会返回 "0000",但订单将无法打款;失败原因(0053 不支援此银行)请通过查询出款单接口的 error_msg 字段确认。
返回示例
{
"error_code": "0000",
"data": { "payout_id": "POT00000001" }
}
备注
重要提示
如遇超时或 HTTP 500 错误,请以订单查询接口状态为依据,不可直接视为订单失败。
- 交易金额单位为 1/100 塔卡(分)。例:出款 100 BDT →
amount传10000 - 单笔限额:最低 100 BDT / 最高 25000 BDT(此为参考值,实际限额依通道配置可能调整,请勿在商户端写死)
- 出款接口启用 IP 白名单,请先向系统人员登记服务器出口 IP,未登记的 IP 请求将被拒绝
- 返回 "0000" 仅代表接口调用成功,请调用查询接口确认结果