PK_JAZZCASH
POST/payments
巴基斯坦 JazzCash 钱包代收。支持直连、交互式空表单和预填模式。direct="1" 时立即请求渠道;autoFill="0" 或 "1" 时返回 PENDING,用户在平台收银台提交后才请求渠道。direct="1" 与 autoFill 互斥,直连和预填均要求手机号。下方为直连示例,三种模式示例见对应 API Reference 页面。
下一步与 action.payContent
在对应 paymentMethod 分支(pkEasypaisa、pkJazzcash、pkEasypaisaQrph 或 pkJazzcashQrph)中选择一种模式。下方 Request 示例提供三种模式。
| 模式 | 参数 | 创建结果 |
|---|---|---|
| 直连 | direct: "1" 和 mobile,不传 autoFill | 通常为 PROCESSING,打开 action.url 继续付款 |
| 空表单 | autoFill: "0",不传 direct | PENDING,打开平台收银台输入手机号并提交 |
| 预填 | autoFill: "1" 和 mobile,不传 direct | PENDING,打开平台收银台确认或修改手机号后提交 |
参数使用字符串 "0"、"1",不要传数字或布尔值。direct="1" 不能与任意 autoFill 值同传。传入的手机号必须为 03 开头的 11 位数字。autoFill="0" 时即使传入 mobile,表单也不预填。
交互式收银台须在订单创建后 30 分钟内提交;即使后台尚未更新订单状态,超时提交也会被拒绝。创建超过 30 分 15 秒仍未提交的订单,由每分钟执行的扫描任务关闭为 EXPIRED,并发送商户回调;实际关单时间可能稍晚。该有效期不适用于直连订单或已提交渠道的订单。过期后须重新创建订单。
两个模式参数都不传时,有手机号则立即请求渠道,没有手机号则进入空表单。direct="0" 本身不代表选择交互式收银台,需要用 autoFill 明确选择;上游的直连配置只影响上游支付流程,不等于平台的表单选择规则。
统一打开 action.url;用户提交前 action.payContent 可能不存在。手机号可在提交前修改,支付方式沿用创建时的选择。商户无需调用托管表单内部的提交接口。HTTP 200、PROCESSING 或浏览器回跳都不表示收款成功,最终结果以查询或验签后的通知为准。默认响应示例对应直连模式。
Request
Responses
- 200
- 400
- 401
- 403
- 409
- 429
- 500
- 503
成功
INVALID_FIELD
UNAUTHORIZED
METHOD_NOT_ENABLED
IDEMPOTENCY_CONFLICT
RATE_LIMITED
INTERNAL_ERROR
SERVICE_UNAVAILABLE