跳至主要內容

代收订单 · 巴基斯坦

TOPPAY Team大约 3 分钟

请求

代收 API 用于向客户发起代收交易。本页为 巴基斯坦(国家码 pk)的代收说明。

请求路径

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

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

请求头

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

请求体

字段必填类型描述
mchNoMString(32)商户编号
orderNumMString(64)商户订单号
amountMNumber交易金额(PKR 整数,50–50000)
productDetailMString(100)产品详情
methodMString(16)支付方式,见 巴基斯坦代收编码
timestampMString(13)时间戳(毫秒)
customerNameMString(64)客户姓名
customerEmailMString(64)客户邮箱
customerPhoneMString(32)客户电话
documentNoCString(100)13 位 CNIC;method=EASYPAISA 时 必填
downNotifyUrlMString(255)异步通知地址
redirectUrlOString(512)支付完成重定向地址(收银台)
signMString签名,见 签名生成

请求体示例

Content-type: application/json

响应字段

method 含义见 地区支付说明 — 巴基斯坦。

字段必填类型描述
successMBoolean请求是否成功
codeMString9999:成功
msgOString响应消息
timeStampMNumber响应时间戳(毫秒)
dataMObject交易数据
orderNumMString商户订单号
platOrderNumMString平台订单号
amountMNumber交易金额(PKR 整数)
feeMNumber手续费
methodMString支付方式,见 地区支付说明 — 巴基斯坦
productDetailMString产品详情
customerNameMString客户姓名
customerEmailMString客户邮箱
customerPhoneMString客户电话
validTimeMNumber过期时间戳(毫秒)
cashierUrlMString收银台 URL

响应示例

{
  "success": true,
  "code": "9999",
  "msg": null,
  "timeStamp": 1767840272829,
  "data": {
    "orderNum": "PK1234561",
    "platOrderNum": "PRE2009093829059153920",
    "amount": 500,
    "fee": 10,
    "method": "EASYPAISA",
    "productDetail": "测试商品",
    "customerName": "Ali Khan",
    "customerEmail": "[email protected]",
    "customerPhone": "03001234567",
    "validTime": 1767926672819,
    "cashierUrl": "https://example.cashier/pay"
  }
}

通知

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

HTTP请求

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

通知体

字段必填类型描述
platOrderNumMString平台订单号
versionMString版本号,固定为 v1
orderNumMString商户订单号,与下单时的 orderNum 相同
amountMNumber交易金额(PKR 整数)
feeMNumber手续费
customerNameMString客户姓名
customerEmailMString客户邮箱
customerPhoneMString客户电话
statusMString交易状态
取值见 交易状态码
signMString回调签名,见 签名生成

返回

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

SUCCESS

通知示例

{
    "platOrderNum": "PRE2009165141186183168",
    "version": "v1",
    "orderNum": "PK1234561",
    "amount": 500,
    "fee": 10,
    "customerName": "Ali Khan",
    "customerEmail": "[email protected]",
    "customerPhone": "03001234567",
    "status": "SUCCESS",
    "sign": "按签名规则校验"
}