支付网关
支持的支付方式
| 方式 | paymentMethod 值 | 说明 |
|---|---|---|
| JazzCash 钱包 | jazzcash / JZ | 需要手机号（钱包号） |
| EasyPaisa | easypaisa / EP | 开发中 |
| 银行转账 | bank_transfer | 手动对账 |
JazzCash 响应码
responseCode | 含义 |
|---|---|
000 | 成功 |
121 | 已支付（paymentResponseCode） |
157 | 余额不足 |
168 | 交易被拒 |
999 | 系统错误 |
每个域名独立商户凭证
JazzCash 按域名绑定不同商户号，后端自动按 domain 选择凭证，前端无需关心：
techconsult.site → MerchantID: MC990199
technologyconsult.org → MerchantID: MC990196
newdomain.pk → 新商户号（在 pk-order-hub 配置）新增域名时，在 pk-order-hub 的 JazzCash 配置里加一条即可，不需要改前端。
JazzCash 回调和查单接口
| 方法 | 路径 | 说明 |
|---|---|---|
GET/POST | /api/jazzcash/return | 固定回调地址，兼容浏览器跳转和服务端通知 |
GET/POST | /api/notify/:callbackId | 商户档案里登记的 token 回调地址 |
POST | /api/jazzcash/inquiry/:orderNo | 管理后台主动查询支付状态，需要 JWT |
/api/notify 和 /api/jazzcash 复用同一套回调处理逻辑；回调报文必须带 pp_TxnRefNo，后端会按订单里的域名读取商户盐并验签。
Payment 字段说明
| 字段 | 说明 |
|---|---|
txnRefNo | JazzCash 交易参考号（T开头） |
retrievalReferenceNo | 网关检索号，对账用 |
authCode | 授权码 |
responseCode | 网关响应码（000 = 成功） |
paymentResponseCode | 支付响应码（121 = 已支付） |
gatewayStatus | Completed / Failed / Pending |
verified | 是否已通过结果查询接口验证 |
lastInquiryAt | 最后一次查询时间 |