代收订单 · 巴基斯坦

请求

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

金额单位为 PKR 整数（无小数），单笔 50 ~ 50,000。
method 及补充参数见地区支付说明 — 巴基斯坦。

请求路径

域名：推荐使用统一域名 openapi.toppayment.com（路径不变）；原国别域名（如 global-pk-openapi.toppayment.com）仍可用。

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

请求头

字段	必填	类型	描述
Content-Type	M	String	固定值：application/json

请求体

字段	必填	类型	描述
mchNo	M	String(32)	商户编号
orderNum	M	String(64)	商户订单号
amount	M	Number	交易金额（PKR 整数，50–50000）
productDetail	M	String(100)	产品详情
method	M	String(16)	支付方式，见巴基斯坦代收编码
timestamp	M	String(13)	时间戳（毫秒）
customerName	M	String(64)	客户姓名
customerEmail	M	String(64)	客户邮箱
customerPhone	M	String(32)	客户电话
documentNo	C	String(100)	13 位 CNIC；`method=EASYPAISA` 时必填
downNotifyUrl	M	String(255)	异步通知地址
redirectUrl	O	String(512)	支付完成重定向地址（收银台）
sign	M	String	签名，见签名生成

请求体示例

Content-type: application/json

{
    "mchNo": "{{mchNo}}",
    "orderNum": "PK1234561",
    "amount": 500,
    "productDetail": "测试商品",
    "method": "EASYPAISA",
    "timestamp": "1749451858772",
    "customerName": "Ali Khan",
    "customerEmail": "[email protected]",
    "customerPhone": "03001234567",
    "documentNo": "3520212345671",
    "downNotifyUrl": "https://example.com/notify",
    "redirectUrl": "https://example.com/return",
    "sign": "按签名规则生成后替换"
}

响应

响应体字段与其他国家代收一致；method 含义见地区支付说明 — 巴基斯坦。

代收订单 · 巴基斯坦

# 请求

# 请求路径

# 请求头

# 请求体

# 请求体示例

# 响应

请求

请求路径

请求头

请求体

请求体示例

响应