跳至主要內容

代付订单 · 巴基斯坦

TOPPAY Team大约 3 分钟

请求

代付 API 用于向受益人发起代付交易。本页为 巴基斯坦(国家码 pk)的代付说明。

请求路径

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

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

请求头

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

请求体

字段必填类型描述
mchNoMString(32)商户编号
orderNumMString(50)商户订单号
amountMNumber交易金额(PKR 整数,50–50000)
bankCodeMString(32)银行/钱包编码,见 巴基斯坦代付编码
bankCardMString(50)收款账号(IBAN/账号/钱包号)
accountNameMString(50)收款人姓名
documentNoMString(100)收款人 13 位 CNIC
feeTypeMNumber(0或1)手续费类型:0 内扣,1 外扣
downNotifyUrlMString(164)异步通知地址
timestampMString(13)时间戳(毫秒)
signMString签名,见 签名生成

请求体示例(IBFT)

Content-type: application/json

响应字段

字段必填类型描述
successMBoolean请求是否成功
codeMString9999:受理成功;其他结果请结合订单状态判断
msgOString响应消息
timeStampMNumber响应时间戳(毫秒)
dataMObject交易数据
orderNumMString商户订单号
platOrderNumMString平台订单号
amountMNumber交易金额(PKR 整数)
feeMNumber手续费
feeTypeMNumber手续费类型:0 内扣,1 外扣
statusMNumber交易状态,见交易状态码
statusMsgMString状态描述
bankCodeMString银行/钱包编码,见 巴基斯坦代付编码
bankCardMString收款账号
accountNameMString收款人姓名
descriptionOString描述

响应示例

{
  "success": true,
  "code": "9999",
  "msg": "SUCCESS",
  "timeStamp": 1767772957433,
  "data": {
    "orderNum": "PKO1234561",
    "platOrderNum": "TRANS2008811496544403456",
    "amount": 1000,
    "fee": 20,
    "feeType": 1,
    "status": 1,
    "statusMsg": "ORDER_RECEIVED_PROCESSING",
    "bankCode": "49",
    "bankCard": "1234567890123456",
    "accountName": "Ali Khan",
    "description": "test"
  }
}

通知

巴基斯坦地区异步通知使用默认版本,version 固定为 v1。

HTTP请求

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

通知体

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

返回

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

SUCCESS

通知示例

{
    "platOrderNum": "TRANS2008812168572567552",
    "version": "v1",
    "orderNum": "PKO1234561",
    "amount": 1000,
    "fee": 20,
    "feeType": 1,
    "status": 2,
    "statusMsg": "SUCCESS",
    "bankCode": "49",
    "bankCard": "1234567890123456",
    "accountName": "Ali Khan",
    "description": "test",
    "sign": "按签名规则校验"
}