代付订单 · 孟加拉

请求

代付 API 用于向受益人发起代付交易。本页为 孟加拉（国家码 bd）的代付说明。

• 金额单位为 BDT，商户侧最多支持两位小数（示例：100、100.99）。
• bankCode 见 地区支付说明 — 孟加拉。

请求路径

域名：推荐使用统一域名 openapi.toppayment.com（路径不变）；原国别域名（如 global-bd-openapi.toppayment.com）仍可用。

环境	地址
沙箱	https://openapi.toppayment.com/sandbox/bd/disbursement/cash
生产	https://openapi.toppayment.com/bd/disbursement/cash

请求头

字段	必填	类型	描述
Content-Type	M	String	固定值：application/json

请求体

字段	必填	类型	描述
mchNo	M	String(32)	商户编号
orderNum	M	String(50)	商户订单号
amount	M	Number	交易金额（BDT，最多两位小数）
bankCode	M	String(32)	钱包编码，见 孟加拉代付编码
bankCard	M	String(50)	收款钱包号，01 开头共 11 位数字
accountName	M	String(50)	收款人姓名
description	O	String(255)	描述
feeType	M	Number(0或1)	手续费类型：0 内扣，1 外扣
downNotifyUrl	M	String(164)	异步通知地址
timestamp	M	String(13)	毫秒时间戳
sign	M	String	RSA 签名，参见 签名生成

请求体示例

{
    "mchNo": "{{mchNo}}",
    "orderNum": "BDPAYOUT1234561",
    "amount": 1000.00,
    "bankCode": "BKASH",
    "bankCard": "01880612345",
    "accountName": "Rahim Uddin",
    "description": "test",
    "feeType": 1,
    "downNotifyUrl": "https://example.com/notify",
    "timestamp": "1749451858772",
    "sign": "按签名规则生成后替换"
}

{
    "mchNo": "{{mchNo}}",
    "orderNum": "BDPAYOUT1234562",
    "amount": 500.50,
    "bankCode": "NAGAD",
    "bankCard": "01880612345",
    "accountName": "Rahim Uddin",
    "description": "test",
    "feeType": 1,
    "downNotifyUrl": "https://example.com/notify",
    "timestamp": "1749451858772",
    "sign": "按签名规则生成后替换"
}

响应

status 见 交易状态码。

{
    "success": true,
    "code": "9999",
    "msg": "SUCCESS",
    "timeStamp": 1767772957433,
    "data": {
        "orderNum": "BDPAYOUT1234561",
        "platOrderNum": "TRANS2008811496544403456",
        "amount": 1000.00,
        "fee": 20.00,
        "feeType": 1,
        "status": 1,
        "statusMsg": "ORDER_RECEIVED_PROCESSING",
        "bankCode": "BKASH",
        "bankCard": "01880612345",
        "accountName": "Rahim Uddin",
        "description": "test"
    }
}

通知

回调字段与代付通用规范一致；status 见 交易状态码。收到后请返回 SUCCESS。