跳至主要內容

代付订单 · 孟加拉

TOPPAY Team大约 2 分钟

请求

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

请求路径

域名:推荐使用统一域名 openapi.toppayment.com(路径不变);原国别域名(如 global-bd-openapi.toppayment.com)仍可用。

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

请求头

字段必填类型描述
Content-TypeMString固定值:application/json

请求体

字段必填类型描述
mchNoMString(32)商户编号
orderNumMString(50)商户订单号
amountMNumber交易金额(BDT,最多两位小数)
bankCodeMString(32)钱包编码,见 孟加拉代付编码
bankCardMString(50)收款钱包号,01 开头共 11 位数字
accountNameMString(50)收款人姓名
descriptionOString(255)描述
feeTypeMNumber(0或1)手续费类型:0 内扣,1 外扣
downNotifyUrlMString(164)异步通知地址
timestampMString(13)毫秒时间戳
signMStringRSA 签名,参见 签名生成

请求体示例

{
    "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": "按签名规则生成后替换"
}

响应

HTTP响应

字段必填类型描述
Content-TypeMStringHTTP响应内容类型规范
固定值:application/json
指示JSON响应格式

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"
    }
}

通知

孟加拉地区回调固定为 v1。

HTTP请求

字段必填类型描述
Content-TypeMString固定值:application/json

通知体

字段必填类型描述
platOrderNumMString平台订单号
versionMString版本号,固定为 v1
orderNumMString商户订单号,与下单时的 orderNum 相同
amountMNumber交易金额(BDT,最多两位小数)
feeMNumber手续费
feeTypeMNumber手续费类型:0 内扣,1 外扣
statusMNumber交易状态
取值见 交易状态码
statusMsgMString状态描述
bankCodeMString钱包编码,见 孟加拉代付编码
bankCardMString收款钱包号
accountNameMString收款人姓名
descriptionOString描述
signMString回调签名,见 签名生成

返回

校验签名后,仅返回字符串 SUCCESS。

SUCCESS

通知示例

{
    "platOrderNum": "TRANS2008812168572567552",
    "version": "v1",
    "orderNum": "BDPAYOUT1234561",
    "amount": 1000.00,
    "fee": 20.00,
    "feeType": 1,
    "status": 2,
    "statusMsg": "SUCCESS",
    "bankCode": "BKASH",
    "bankCard": "01880612345",
    "accountName": "Rahim Uddin",
    "description": "test",
    "sign": "按签名规则校验"
}