跳转到主要内容
阅读该接口文档前,务必先查看 接口说明

限额

交易类型限额
代收孟加拉塔卡: 100-50000
代付孟加拉塔卡: 100-50000

代收API

代收申请

简要描述:
  • 创建代收订单
URL: 塔卡:/bdt/collect/apply 说明:appId需使用塔卡对应的,用户支付成功后增加塔卡余额 参数:
参数名必选类型说明
appIdLong业务ID(后台获取,需要根据URL中的币种传递对应的业务ID)
orderIdString商户订单号(必须保证唯一性,长度不超过48)
nameString用户姓名,推荐使用真实姓名,格式:包含firstName和lastName,以空格分割的,示例:Donald John Trump
phoneString真实手机号(格式参考 电话号码格式
emailString真实电子邮件
amountString交易金额(精确到小数点后两位;禁止添加标点符号,例如:”,”)
payTypeString交易类型
inBankCodeString支付方式
callBackUrlString用户支付成功后跳转地址
callBackFailUrlString用户支付失败后跳转地址
notifyUrlString回调地址
subjectString支付备注
bodyString备注详情
partnerUserIdString用户唯一标识(如用户ID userId),用于风控系统,必须真实有效,否则会影响交易。 格式要求:数字、大小写字母或常用符号-~!@#$%&*()_。
signString签名
返回data参数说明
参数名类型说明
orderIdString商户订单号
orderNoString平台订单号
payUrlString支付链接
signString签名

代收查询

简要描述:
  • 查询代收订单
URL: 塔卡:/bdt/collect/query 参数:
参数名必选类型说明
appIdLong业务ID(后台获取,需要根据URL中的币种传递对应的业务ID)
orderIdString商户订单号
orderNoString平台订单号(响应快)
signString签名
返回data参数说明
参数名类型说明
orderIdString商户订单号
orderNoString平台订单号
amountString交易金额
actualAmountString收到金额
feeString手续费
statusInteger状态(0未开始,1支付中,2成功(终态),3失败(终态), -1异常待确认)
payTimeString支付成功时间(当status=2时有值)(币种时间 UTC+06:00), 格式: yyyy-MM-dd HH:mm:ss
errorMsgString支付失败原因(当status=3时有值)
signString签名

支付方式

币种支付类型(payType)支付编码(inBankCode)限额状态说明
BDTEWALLETBDT_BKASH100-50000可用bkash
BDTEWALLETBDT_NAGAD100-50000可用nagad

代付API

代付申请

简要描述:
  • 创建代付订单
URL:/bdt/pay/apply 参数:
参数名必选类型说明
appIdLong业务ID(后台获取,需要根据URL中的币种传递对应的业务ID)
orderIdString商户订单号(必须保证唯一性,长度不超过48)
amountString交易金额(精确到小数点后两位;禁止添加标点符号,例如:”,”)
accountTypeString账户类型:EWALLET(电子钱包) , BANK_ACCOUNT(银行)
bankCodeString支付方式
accountNoString用户账号
nameString收款人姓名(收款人姓名 格式:英文大小写且允许有空格,1-30位,“firstName middleName lastName” (middleName 非必填, 特殊字符支持 ’.-))
phoneString真实手机号(格式参考 电话号码格式
emailString真实电子邮件
notifyUrlString回调地址
subjectString支付备注(交易标题,商品名称,支付原因)
bodyString备注详情
partnerUserIdString用户唯一标识(如用户ID userId),用于风控系统,必须真实有效,否则会影响交易。 格式要求:数字、大小写字母或常用符号-~!@#$%&*()_。
signString签名
返回data参数说明
参数名必选类型
orderIdString商户订单号(必须保证唯一性)
orderNoString平台订单号
signString签名

代付查询

URL:/bdt/pay/query 参数:
参数名必选类型说明
appIdLong业务ID(后台获取,需要根据URL中的币种传递对应的业务ID)
orderIdString商户订单号
orderNoString平台订单号(响应快)
signString签名
返回data参数说明
参数名类型说明
orderIdString商户订单号(必须保证唯一性)
orderNoString平台订单号
amountString交易金额
feeString手续费
statusInteger状态(0未开始,1支付中,2成功(终态),3失败(终态), -1异常待确认)
payTimeString支付成功时间(当status=2时有值)(币种时间 UTC+06:00), 格式: yyyy-MM-dd HH:mm:ss
errorMsgString支付失败原因(当status=3时有值)
signString签名

支付方式

币种支付类型(accountType)支付编码(bankCode)限额状态说明
BDTEWALLETBDT_BKASH100-50000可用bkash
BDTEWALLETBDT_NAGAD100-50000可用nagad
Last modified on April 17, 2026