附录 · 枚举与说明
代收 bankCode 枚举
创建代收时请使用 大写 平台编码填写 bankCode。bankName 仅作为下表展示名，新接入无需传递。
| bankCode | 展示名 | 说明 |
|---|---|---|
EASYPAISA | EASYPAISA | Easypaisa 钱包 |
JAZZCASH | JAZZCASH | JazzCash 钱包 |
PAYLINK | PAYLINK | PayLink |
QRANDLAUNCH | QRANDLAUNCH | 扫码/收银台 |
代付 bankCode 枚举
创建代付时请使用下表 大写 编码填写 bankCode。bankName 仅作为下表展示名，新接入无需传递。类型为 钱包 时优先填 payee_mobile；银行 时优先填 payee_account。
| bankCode | 展示名 | 类型 |
|---|---|---|
JAZZCASH | JAZZCASH | 钱包 |
EASYPAISA | EASYPAISA | 钱包 |
ABHI FINANCE SERVICES LIMITED | ABHI FINANCE SERVICES LIMITED | 银行 |
AFT | AFT | 银行 |
AFT IBFT | AFT IBFT | 银行 |
ADVANS | ADVANS | 银行 |
AL MEEZAN INVESTMENT MANAGEMENT LIMITED | AL MEEZAN INVESTMENT MANAGEMENT LIMITED | 银行 |
ALHABIB | ALHABIB | 银行 |
ALBARKA | ALBARKA | 银行 |
ALFALAH | ALFALAH | 银行 |
ALLIED | ALLIED | 银行 |
APNA | APNA | 银行 |
ASKARI | ASKARI | 银行 |
BOK | BOK | 银行 |
BYKEA | BYKEA | 银行 |
BANKISLAMI | BANKISLAMI | 银行 |
BURJ | BURJ | 银行 |
CENTRAL DIRECTORATE OF NATIONAL SAVINGS | CENTRAL DIRECTORATE OF NATIONAL SAVINGS | 银行 |
CENTRAL DIRECTORATE OF NATIONAL SAVINGS (CDNS) | CENTRAL DIRECTORATE OF NATIONAL SAVINGS (CDNS) | 银行 |
CENTRAL DIRECTORATE OF NATIONAL SAVINGS – 1IBFT IMD ADDITION | CENTRAL DIRECTORATE OF NATIONAL SAVINGS – 1IBFT IMD ADDITION | 银行 |
CITI | CITI | 银行 |
DUBAIISLAMIC | DUBAIISLAMIC | 银行 |
EZ WAGE | EZ WAGE | 银行 |
FINCA | FINCA | 银行 |
FINJA | FINJA | 银行 |
FWBL | FWBL | 银行 |
FAYSAL | FAYSAL | 银行 |
FIRST MICROFINANCE BANK | FIRST MICROFINANCE BANK | 银行 |
HBL | HBL | 银行 |
HBL ASSET MANAGEMENT | HBL ASSET MANAGEMENT | 银行 |
HABIB METRO BANK – BULK 1IBFT | HABIB METRO BANK – BULK 1IBFT | 银行 |
HABIBMETRO | HABIBMETRO | 银行 |
HUMRAH FINANCIAL SERVICES | HUMRAH FINANCIAL SERVICES | 银行 |
ICBC | ICBC | 银行 |
JS | JS | 银行 |
KASB | KASB | 银行 |
KBL | KBL | 银行 |
KEENU | KEENU | 银行 |
MCB | MCB | 银行 |
MCB-ARIF HABIB | MCB-ARIF HABIB | 银行 |
MIB | MIB | 银行 |
MEEZAN | MEEZAN | 银行 |
MOBILINKBANK PAKISTAN | MOBILINKBANK PAKISTAN | 银行 |
NAYAPAY | NAYAPAY | 银行 |
NBP | NBP | 银行 |
NBP FUND MANAGEMENT LIMITED | NBP FUND MANAGEMENT LIMITED | 银行 |
NBP1 | NBP1 | 银行 |
NIB | NIB | 银行 |
NRSP | NRSP | 银行 |
NATIONAL BANK | NATIONAL BANK | 银行 |
NUMBERS PRIVATE LIMITED | NUMBERS PRIVATE LIMITED | 银行 |
PAYMAX | PAYMAX | 银行 |
PAYMAX1 | PAYMAX1 | 银行 |
PUNJABBANK | PUNJABBANK | 银行 |
SADAPAY | SADAPAY | 银行 |
SCB | SCB | 银行 |
SEEDCREED FINANCIAL SERVICES LIMITED | SEEDCREED FINANCIAL SERVICES LIMITED | 银行 |
SIMPAISA | SIMPAISA | 银行 |
SIND | SIND | 银行 |
SAMBA | SAMBA | 银行 |
SILK | SILK | 银行 |
SINDHBANK | SINDHBANK | 银行 |
SONERI | SONERI | 银行 |
SUMMIT | SUMMIT | 银行 |
TAG | TAG | 银行 |
TEZPAY | TEZPAY | 银行 |
UBL | UBL | 银行 |
UPAISA | UPAISA | 银行 |
WASEELA | WASEELA | 银行 |
ZTBL1 | ZTBL1 | 银行 |
CDNS | CDNS | 银行 |
KHYBER | KHYBER | 银行 |
MCB ISLAMIC BANK | MCB ISLAMIC BANK | 银行 |
TELENOR MICROFINANCE BANK | TELENOR MICROFINANCE BANK | 银行 |
U MICROFINANCE BANK | U MICROFINANCE BANK | 银行 |
UNITED | UNITED | 银行 |
TAMEER MICROFINANCE BANK | TAMEER MICROFINANCE BANK | 银行 |
STANDARD CHARTERED BANK | STANDARD CHARTERED BANK | 银行 |
SINDH MICRO FINANCE BANK | SINDH MICRO FINANCE BANK | 银行 |
SME BANK | SME BANK | 银行 |
字段命名规范
| 场景 | 字段 | 说明 |
|---|---|---|
| 付款人 | payer_mobile | 手机（PKR 代收必填，03 开头 11 位真实号码） |
| 付款人 | payer_realname | 姓名 |
| 付款人 | payer_email | 邮箱 |
| 付款人 | payer_id_no | 证件号 |
| 收款人 | payee_realname | 姓名 |
| 收款人 | payee_account | 账号 |
| 收款人 | payee_mobile | 手机 |
| 收款人 | payee_email | 邮箱 |
| 收款人 | payee_id_no | 证件号 |
| 通用 | remark | 备注（顶层） |
| 通用 | extJson | 扩展对象 |
| 渠道 | bankCode | 代收、代付均使用；历史字段 bankName 兼容接收但不参与处理 |
已废弃： metadata、countryCode/currency（创建时）、bankName（新接入无需传递）、receiverName、receiverAccount、receiverBankCode、receiverBankName、receiverPhone。
代付订单状态
| status | 终态 | 说明 |
|---|---|---|
created | 否 | 已创建 |
market_available | 否 | 已发布至任务市场（P2P） |
processing | 否 | 处理中 |
completed | 是 | 代付成功，触发回调 |
failed | 是 | 失败 |
cancelled | 是 | 已取消，冻结款退回 |
代收订单状态
| status | 终态 | 说明 |
|---|---|---|
created | 否 | 已创建 |
processing | 否 | 处理中 |
completed | 是 | 已入账，触发回调 |
failed | 是 | 失败 |
cancelled | 是 | 已取消 |
手续费与 netAmount
| 订单类型 | fee 计算 | netAmount 含义 |
|---|---|---|
| payin | amount × rate + fixed | 商户入账 = amount - fee |
| payout | amount × rate + fixed | 商户扣款 = amount + fee |
回调 orderType
| 值 | 说明 |
|---|---|
payin | 代收完成通知 |
payout | 代付完成通知 |
extJson 说明
extJson 为可选 JSON 对象，用于存放商户自定义扩展数据，平台原样存库。不参与 签名以外的上游路由必填映射。请勿将付款人/收款人必填信息只放在 extJson 中。
商户开户交付物
| 项目 | 接收方 |
|---|---|
merchantNo | 商户 |
| 平台 RSA 公钥（PEM） | 商户（回调验签，见 异步回调指南） |
| 商户 RSA 公钥（PEM） | 平台（请求验签；商户可在门户 商户资料 → API 配置 自行更新） |
默认 callbackUrl | 平台配置（代付 notifyUrl 为空时使用） |
| 手续费规则 | 平台后台配置 |