跳到主要内容

创建出款单(孟加拉)

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

请求资讯

  • 请求 URL: /gateway/api/v2/payouts
  • 请求方式: POST
  • Content-Type: application/json;charset=utf-8

请求参数

参数名必选类型说明
platform_idString(6)商户 ID
service_idString(7)服务 ID,固定值 SVC0004
payout_cl_idString(64)商户订单号
amountInteger(10)金额(分)
notify_urlString(256)交易结果通知地址
bank_nameString(45)钱包代码,NAGADBKASH,详见钱包列表
nameString(2-64)受款人户名(至少 2 个字符)
numberString(5-64)受款人钱包帐号(手机号,至少 5 个字符)
currencyString(3)固定值:bdt
request_timeInteger(10)请求时间(秒)
sign_typeString(16)签名类型,固定值 HMAC-SHA256
signString(32|64)订单签名

服务 ID

  • SVC0004 钱包代付(Nagad / bKash)
钱包代码

bank_name 仅支援 NAGADBKASH(大小写不敏感)。rocketupay 暂不支援——注意:传入不支援的钱包时,建单接口仍会返回 "0000",但订单将无法打款;失败原因(0053 不支援此银行)请通过查询出款单接口的 error_msg 字段确认。

返回示例

{
"error_code": "0000",
"data": { "payout_id": "POT00000001" }
}

备注

重要提示

如遇超时或 HTTP 500 错误,请以订单查询接口状态为依据,不可直接视为订单失败。

  • 交易金额单位为 1/100 塔卡(分)。例:出款 100 BDT → amount10000
  • 单笔限额:最低 100 BDT / 最高 25000 BDT(此为参考值,实际限额依通道配置可能调整,请勿在商户端写死)
  • 出款接口启用 IP 白名单,请先向系统人员登记服务器出口 IP,未登记的 IP 请求将被拒绝
  • 返回 "0000" 仅代表接口调用成功,请调用查询接口确认结果