跳到主要内容

创建收款单(巴基斯坦)

创建巴基斯坦卢比(PKR)收款订单接口。

请求资讯​

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

请求参数​

参数名必选类型说明
platform_id是String(6)商户 ID
service_id是String(7)服务 ID
payment_cl_id是String(64)商户订单号
amount是Integer(10)金额(分)
notify_url是String(256)交易结果通知地址
bank_name否String(16)银行代码,银行列表
name否String(16)汇款人户名
phone_number否String(11)付款人手机号,最长 11 位,例如 03001234567。部分渠道必填,未传时返回错误码 0084(手机号码为必填字段);与其他参数一样参与签名
last_number否String(32)付款人银行帐号或 IBAN(如 PK36SCBL0000001123456702),仅限英文字母与数字,不可含空格或 -。SVC0120 必填,见备注
identity_no否String(15)付款人身份证号(CNIC),13 位数字,可带 -,例如 35202-1234567-1。SVC0120 必填,见备注
request_time是Integer(10)请求时间(秒)
sign_type否String(16)签名类型,固定值 HMAC-SHA256
sign是String(32|64)订单签名

服务 ID​

  • SVC0070 EASYPAISA
  • SVC0071 JAZZCASH
  • SVC0120 银行转账

返回示例​

成功返回​

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

备注​

  • 交易金额单位为巴基斯坦卢比(分),请乘以 100 传入
  • 请求时间使用 Unix timestamp,单位为秒
  • 交易结果将通知至 notify_url,参数规范见 交易结果通知
  • 使用 SVC0120 银行转账时须同时传入 last_number 与 identity_no(两者与其他参数一样参与签名)。缺少或格式不符时下单失败,返回错误码 0045:
    • last_number 缺少或格式不符:error_msg 为 last_number is required!
    • identity_no 缺少或格式不符(如非 13 位数字):error_msg 为 identify_no is required!
    • 请修正参数后重新下单,详见 0045 错误讯息列表