跳到主要内容

创建收款单（孟加拉）

创建孟加拉塔卡（BDT）收款订单接口。孟加拉代收为移动钱包（Nagad / bKash / Rocket）通道，创建成功后系统返回收银台链接，付款人于收银台完成钱包转帐。

请求资讯​

  • 请求 URL： /gateway/api/v2/payments
  • 请求方式： POST
  • Content-Type： application/json;charset=utf-8

请求参数​

参数名必选类型说明
platform_id是String(6)商户 ID
service_id是String(7)服务 ID，SVC0088（Nagad）、SVC0091（bKash）、SVC0093（Rocket）或 SVC0105（Upay）
payment_cl_id是String(64)商户订单号
amount是Integer(10)金额（分）
notify_url是String(256)交易结果通知地址
request_time是Integer(10)请求时间（秒）
sign_type否String(16)签名类型，固定值 HMAC-SHA256
sign是String(32|64)订单签名
关于收款钱包

孟加拉代收的钱包类型由 service_id 决定（SVC0088 = Nagad、SVC0091 = bKash、SVC0093 = Rocket、SVC0105 = Upay），商户无需在建单时指定 bank_name。

服务 ID​

  • SVC0088 孟加拉钱包代收（Nagad）
  • SVC0091 孟加拉钱包代收（bKash）
  • SVC0093 孟加拉钱包代收（Rocket）
  • SVC0105 孟加拉钱包代收（Upay）

返回示例​

成功返回​

{
  "error_code": "0000",
  "data": {
    "link": "https://pay.example.com/cashier/DEMOPM0123456",
    "payment_id": "DEMOPM0123456",
    "payment_cl_id": "order_20260112001",
    "amount": 10000
  }
}

备注​

  • 交易金额单位为 1/100 塔卡（分）。例：收款 100 BDT → amount 传 10000
  • 单笔限额：最低 100 BDT / 最高 25000 BDT（此为参考值，实际限额依通道配置可能调整，请勿在商户端写死）
  • 请求时间使用 Unix timestamp，单位为秒
  • data.link 为收银台链接，请引导付款人前往完成钱包转帐
  • 交易结果将通知至 notify_url，参数规范见 交易结果通知
  • data 未来可能返回更多字段，请动态解析，切勿写死字段集