代付订单 · 巴基斯坦
大约 1 分钟
请求
代付 API 用于向受益人发起代付交易。本页为 巴基斯坦(国家码 pk)的代付说明。
- 金额单位为 PKR 整数(无小数),单笔 50 ~ 50,000。
- 代付须传
documentNo(收款人 13 位 CNIC)。 bankCode见 地区支付说明 — 巴基斯坦。
请求路径
域名:推荐使用统一域名
openapi.toppayment.com(路径不变);原国别域名(如global-pk-openapi.toppayment.com)仍可用。
| 环境 | 地址 |
|---|---|
| 沙箱 | https://openapi.toppayment.com/sandbox/pk/disbursement/cash |
| 生产 | https://openapi.toppayment.com/pk/disbursement/cash |
请求头
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Content-Type | M | String | 固定值:application/json |
请求体
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| mchNo | M | String(32) | 商户编号 |
| orderNum | M | String(50) | 商户订单号 |
| amount | M | Number | 交易金额(PKR 整数,50–50000) |
| bankCode | M | String(32) | 银行/钱包编码,见 巴基斯坦代付编码 |
| bankCard | M | String(50) | 收款账号(IBAN/账号/钱包号) |
| accountName | M | String(50) | 收款人姓名 |
| documentNo | M | String(100) | 收款人 13 位 CNIC |
| feeType | M | Number(0或1) | 手续费类型:0 内扣,1 外扣 |
| downNotifyUrl | M | String(164) | 异步通知地址 |
| timestamp | M | String(13) | 时间戳(毫秒) |
| sign | M | String | 签名,见 签名生成 |
请求体示例(IBFT)
Content-type: application/json
{
"mchNo": "{{mchNo}}",
"orderNum": "PKO1234561",
"amount": 1000,
"bankCode": "49",
"bankCard": "1234567890123456",
"accountName": "Ali Khan",
"documentNo": "3520212345671",
"feeType": 1,
"downNotifyUrl": "https://example.com/notify",
"timestamp": "1749451858772",
"sign": "按签名规则生成后替换"
}
响应
响应体字段与其他国家代付一致。
