BDT 代付接口（bKash / Nagad）

文章信息: 分类：BDT(孟加拉)接口

接口说明

币种：BDT（孟加拉塔卡）。本接口支持 bKash、Nagad 钱包代付。同步返回成功仅表示请求已受理，最终到账结果以异步回调或订单查询结果为准。

环境说明：本代付接口当前连接沙箱环境，正式使用前须完成生产环境配置与联调确认；商户请求地址和 payment_code 以实际分配为准。

请求地址：https://{请求地址}/Payment_AddOrder
请求方式：POST
Content-Type：application/x-www-form-urlencoded; charset=utf-8

请求参数

参数名	必选	类型	说明
mchid	是	string	支付系统分配的商户号
applydate	是	string	发起代付时间，格式 yyyy-MM-dd HH:mm:ss
out_trade_no	是	string	商户唯一订单号，避免重复提交
payment_code	是	string	BDT 代付产品编码，联系客服获取
money	是	string	BDT 代付金额，保留两位小数，不带千位分隔符；实际金额范围以通道配置为准
bankname	是	string	收款钱包编码：bKash 填 "060"，Nagad 填 "280"；务必作为字符串保留前导零
accountnumber	是	string	收款钱包账号，原样传递并保留前导零，最长16字符
userid	是	string	交易用户 ID；无法提供时可使用玩家手机号等替代值
notifyurl	是	string	商户服务端异步回调地址，参见公共“代付回调”文档
accountname	是	string	收款账户持有人姓名
pay_md5sign	是	string	商户 MD5 签名，签名字段本身不参与签名

钱包编码

bankname	钱包
060	bKash Limited
280	Nagad Limited

请使用以上数字编码。编码与账号均使用字符串传递。

签名规则

将请求中非空参数（不含 pay_md5sign）按参数名 ASCII 字典序升序排列，以 key=value&key=value 拼接，最后追加 &key={商户MD5密钥}。对完整字符串执行 MD5，并将结果转为大写，填入 pay_md5sign。请使用商户后台分配的 MD5 密钥。

请求示例（bKash）

以下为字段展示，实际按表单方式提交；替换分配值后重新计算签名。Nagad 请求将 bankname 改为 "280"，并填写对应钱包账号。

{
  "mchid": "{商户号}",
  "applydate": "2026-10-13 12:00:00",
  "out_trade_no": "BDTOUT202610130001",
  "payment_code": "{分配的BDT代付产品编码}",
  "money": "1000.00",
  "bankname": "060",
  "accountnumber": "01321123456",
  "userid": "USER0001",
  "notifyurl": "https://merchant.example.com/bdt/withdrawal-notify",
  "accountname": "Example User",
  "pay_md5sign": "{按上述规则计算的32位大写MD5}"
}

响应参数

参数名	类型	说明
success	boolean	true：请求受理成功；false：提交失败。不是最终到账状态
errCode	string	受理成功为 "0"；当前通道提交失败分支为 "-100"
errMsg	string	受理成功为 "Success"；当前通道提交失败分支原样返回 "faild"

受理成功返回示例

{
  "success": true,
  "errCode": "0",
  "errMsg": "Success"
}

提交失败返回示例

{
  "success": false,
  "errCode": "-100",
  "errMsg": "faild"
}

结果确认与注意事项

收到 success=true 后保持订单为处理中，不要直接判定已到账。
最终结果使用公共“代付回调”文档约定的商户通知格式，或通过公共“代付订单查询”接口确认。
商户回调应验签并按 out_trade_no 幂等处理。状态定义以公共“代付回调”文档为准。
若请求超时或结果未知，先查询原订单状态，再决定后续处理，避免重复代付。
手续费从商户余额扣除；费用和余额要求以商户通道配置为准。

eoopay技术文档