跳到主要内容

创建出款单(孟加拉)

创建孟加拉塔卡(BDT)出款订单接口。孟加拉代付为移动钱包(Nagad / bKash / Rocket)转帐。

请求资讯​

  • 请求 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、ROCKET 或 UPAY,详见钱包列表
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 钱包代付(由 bank_name 区分钱包)
  • SVC0094 Nagad 代付 SVC0095 bKash 代付 SVC0096 Rocket 代付 SVC0106 Upay 代付
  • 按钱包分服务时钱包由服务 ID 决定;若同时传 bank_name,两者必须一致,否则订单被拒
钱包代码

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" 仅代表接口调用成功,请调用查询接口确认结果