eoopay技术文档

BDT 代收接口（Nagad / bKash）

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

接口说明

币种：BDT（孟加拉塔卡）。本接口支持 Nagad 和 bKash 钱包代收。通过商户后台分配的 pay_bankcode 选择钱包；两种方式使用相同的商户接口参数。最低下单金额为 1000.00 BDT。

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

请求参数

参数名 必选 是否参与签名 说明
pay_memberid 是 是 支付系统分配的商户号
pay_orderid 是 是 商户唯一订单号；与响应中的平台订单号 order_sn 区分
pay_applydate 是 是 请求时间，格式 yyyy-MM-dd HH:mm:ss
pay_bankcode 是 是 商户后台“通道管理 → 通道费率”中分配的 Nagad 或 bKash 代收通道编码；不要直接填写钱包名称或代付银行编码
pay_notifyurl 是 是 商户服务端异步回调地址，回调格式参见公共“代收回调”文档
pay_callbackurl 是 是 商户页面返回地址；页面返回不能作为到账依据
pay_userid 是 是 交易用户 ID；无法提供时可使用玩家手机号等替代值
pay_amount 是 是 BDT 金额，至少 1000.00，建议使用两位小数字符串，不带千位分隔符
pay_md5sign 是 否 商户 MD5 签名，按下述规则生成
type 否 否 json：返回平台收银台链接；string：返回钱包收银台链接；其他值或不传：跳转钱包收银台

签名规则

仅选取上表标为“参与签名”的非空参数，按参数名 ASCII 字典序升序排列，以 key=value&key=value 拼接，再追加 &key={商户MD5密钥}。对完整字符串执行 MD5，并将结果转为大写，作为 pay_md5sign。密钥从商户后台获取。

请求示例

以下为字段展示，实际按表单方式提交；替换商户号、通道编码和回调地址后重新计算签名。

{
  "pay_memberid": "{商户号}",
  "pay_orderid": "BDTIN202610130001",
  "pay_applydate": "2026-10-13 12:00:00",
  "pay_bankcode": "{分配的Nagad或bKash代收通道编码}",
  "pay_notifyurl": "https://merchant.example.com/bdt/notify",
  "pay_callbackurl": "https://merchant.example.com/bdt/return",
  "pay_userid": "USER0001",
  "pay_amount": "1000.00",
  "pay_md5sign": "{按上述规则计算的32位大写MD5}",
  "type": "json"
}

响应参数

type=json 和 type=string 均返回 JSON；以下为成功响应字段。

参数名 类型 说明
code string / integer 成功为 1。type=json 时为字符串 "1"，type=string 时为整数 1；下单失败为 0
msg string 成功为 Success；失败信息包括“pay_amount最小金额为1000”或“下单失败”
money string 订单 BDT 金额，保留两位小数，例如 "1000.00"
order_sn string 平台生成的订单号
payUrl string type=json：平台 /Pay_Pay_pay.html?orderid={平台订单号} 链接；type=string：钱包收银台链接

成功返回示例（type=json）

{
  "code": "1",
  "msg": "Success",
  "money": "1000.00",
  "order_sn": "20261013120000000001",
  "payUrl": "https://{请求地址}/Pay_Pay_pay.html?orderid=20261013120000000001"
}

支付结果与注意事项

  • 下单成功和获得 payUrl 仅表示已创建收款订单。以商户服务端异步通知或公共“代收订单查询”结果确认支付成功。
  • 商户回调按公共“代收回调”文档验签，并按订单号幂等处理，避免重复入账。
  • 本接口下单响应使用 code、money、order_sn、payUrl 等字段，请按响应参数表解析。
  • 商户请求使用 MD5 规则，回调使用公共回调规则。

Main menu zh-CN