# 开放接口附录 - 代付银行编码与银行列表说明

**版本日期**：2026-05-31
**适用接口**：`POST /api/PayRequest/UnifiedPayout`

---

## 1. 使用说明

当统一代付产品的账户类型为 `BANK`、`PERSONAL_BANK`、`BANK_CARD`、`ACH`、`CLABE`、`PIX_BANK` 等银行类场景时，商户除了传 `payeeAccount` 之外，通常还需要补一个“银行识别字段”。这个字段在不同上游的真实语义并不相同：

- 有的是银行 `bankid`
- 有的是银行 `bankCode`
- 有的是 `transferCode`
- 有的是 `IFSC`
- 有的是 `routingNumber`
- 有的是巴西 `ISPB`

因此主文档只给“摘要提示”，具体值域、来源和填写建议统一放在本附录。

## 2. 怎么看这页

- `codeField`：商户在开放接口里实际要传的字段。
- `valueType`：这个字段真实承载的值域类型。
- `sourceType`：
  - `public_url`：官方公开列表页
  - `public_doc`：在线公开文档页
  - `appendix_only`：本次只保留说明，不公开完整列表
  - `restricted_doc`：来源受限，仅给字段语义
  - `self_fill`：商户自行填写银行识别码
- “样例值”只用于帮助理解，不代表完整列表。

## 3. 渠道总览

| 渠道 | 国家 | `codeField` | `valueType` | 来源 | 商户建议 |
| --- | --- | --- | --- | --- | --- |
| `dfpay` | `ID/PK/VN` | `payeeBankCode` | `bankid` | 公开列表 | 直接按官方银行表传 `bankid` |
| `tlpay` | `TH` | `payeeBankCode` | `bankCode` | 公开文档 | 按在线“银行编码”页枚举传值 |
| `tlpay` | `IN` | `payeeBankCode` | `bankCode` | 仅附录说明 | 先向平台获取当前编码模板 |
| `ynuopay` | `PH` | `payeeBankCode` | `transferCode` | 公开文档 | 既可能是银行，也可能是钱包编码 |
| `ynuopay` | `VN` | `payeeBankCode` | `bankCode` | 公开文档 | 优先按产品配置，必要时再显式指定 |
| `ynuopay` | `MX` | `payeeBankCode` | `bankCode` | 公开文档 | 同时补 `payeeBankName` |
| `ynuopay` | `IN` | `ifsc` | `IFSC` | 商户自填 | 按收款行真实 IFSC 填写 |
| `infyric` | `IN` | `ifsc` | `IFSC` | 商户自填 | IFSC 不走平台银行枚举 |
| `novavexis` | `BR` | `payeeBankCode` | `ISPB` | 仅附录说明 | `PIX_BANK` 传 ISPB，不传银行名文本 |
| `gxppay` | `BR` | `payeeBankCode` | `ISPB` | 仅附录说明 | 与 `novavexis` 同构 |
| `fzpay` | `PH` 等 | `payeeBankCode` | `bankCode` | 受限文档 | 联系平台获取最新模板 |
| `cowpay` | `BD/US/PK` | `payeeBankCode` | `bankCode` | 仅附录说明 | 不同国家口径不同，按模板传值 |
| `cowpay` | `IN` | `ifsc` | `IFSC` | 商户自填 | 平台统一要求放 `ifsc` |
| `fixpay` | `BR` | `payeeBankCode` | `PIX账号类型` | 受限文档 | 传 `CPF/CNPJ/PHONE/EMAIL/EVP` |
| `fixpay` | `PH` | `payeeBankCode` | `walletCode` | 受限文档 | 传 `GRABPAY/GCASH/PAYMAYA` |
| `phpay` | `PH` | `payeeType` | `walletType` | 公开文档 | 钱包类只传平台标准 `GCASH/MAYA`，平台映射上游 `GCash/maya` |
| `phpay` | `PH` | `payeeBankCode` | `upstream type` | 公开文档 | 银行类传 Phpay `type`，例如 `GW_BDO/GW_BPI` |
| `payx` | `IN` | `ifsc` | `IFSC` | 商户自填 | 上游字段名和真实语义不完全一致 |
| `eqpay` | `US` | `payeeBankCode` | `routingNumber` | 商户自填 | 仅 `ACH` 场景使用 |

---

<a id="dfpay-bank-list"></a>
## 4. Dfpay

### 4.1 字段映射

- 适用账户类型：`BANK` / `BANK_CARD` / `PERSONAL_BANK`
- 商户字段：`payeeBankCode`
- 上游字段：`bankid`
- 值域类型：`bankid`
- 来源：[官方银行列表](https://dxgj68.com/xa8pzzbf79rqtsfn_Index_banklist.html)

### 4.2 接入建议

- 银行卡代付时，平台固定上送 `accounttype=1`。
- `payeeAccount` 映射上游 `cardnumber`。
- `payeeBankCode` 原样映射上游 `bankid`。
- 官方银行表是动态维护的，联调和生产都应以当前商户环境对应的官方列表页最新值为准；测试环境与生产环境的 `bankid` 不保证完全一致，不要跨环境复用。

### 4.3 样例值

| 国家 | `bankid` | 银行名称 |
| --- | --- | --- |
| `ID` | `63` | `BCA` |
| `ID` | `68` | `BNI` |
| `ID` | `69` | `BRI` |
| `ID` | `70` | `BTN` |
| `ID` | `125` | `Bank jago` |

---

<a id="tlpay-th-bank-code"></a>
## 5. TLPay - 泰国银行编码

### 5.1 字段映射

- 适用账户类型：`BANK` / `BANK_CARD` / `PERSONAL_BANK`
- 商户字段：`payeeBankCode` + `payeeBankName`
- 上游字段：`bankId` + `bankName`
- 值域类型：`bankCode`
- 来源：[Eolink 在线文档](https://www.eolink.com/share/inside/1947f1f1ffd4f82a434ab6c0d5c19881/api/3373703/detail/56509658)

### 5.2 接入建议

- 银行卡类代付不要把银行名当作自由文本乱填。
- `payeeBankCode` 应使用在线文档里的银行编码枚举。
- `payeeBankName` 建议与编码对应的银行名称保持一致。

### 5.3 在线样例

| `bankCode` | 银行名称 |
| --- | --- |
| `TH0001` | `Siam Commercial Bank` |
| `TH0002` | `Bank for Agriculture and Agricultural Cooperatives` |
| `TH0003` | `Bank of Ayudhya` |
| `TH0004` | `Bangkok Bank` |
| `TH0013` | `Kasikorn Bank` |
| `TH0015` | `Krung Thai Bank` |
| `TH0020` | `TMBThanachat bank` |

<a id="tlpay-in-bank-code"></a>
### 5.4 印度银行编码

- 当前已确认 TLPay 印度银行卡产品也要求 `payeeBankCode + payeeBankName`。
- 但本次未抓到稳定可公开银行表页，因此主文档只提示“需 `bankCode`，见附录”。
- 如商户要接 TLPay 印度银行卡代付，请先向平台获取最新银行编码模板。

---

<a id="ynuopay-ph-bank-code"></a>
## 6. Ynuopay - 菲律宾代付银行编码

### 6.1 字段映射

- 商户字段：`payeeBankCode`
- 上游字段：`transferCode`
- 值域类型：`transferCode`
- 来源：[Apifox 在线文档](https://ynuopay.apifox.cn/api-283909995)

### 6.2 关键说明

- 这个列表不是“纯银行列表”。
- 它同时包含银行和钱包/支付方式编码。
- 因此商户文档应写成“银行编码/列表”，不能只写“银行名称”。

### 6.3 在线样例

| `transferCode` | `bankName` |
| --- | --- |
| `gcash` | `Gcash` |
| `BPI Bank` | `BPI Bank` |
| `BDO Unibank` | `BDO Unibank` |
| `Metropolitan Bank and Trust Co` | `Metropolitan Bank and Trust Co` |
| `LANDBANK / OFBank` | `LANDBANK / OFBank` |
| `Union Bank of the Philippines` | `Union Bank of the Philippines` |
| `Maya Bank, Inc.` | `Maya Bank, Inc.` |
| `PayMaya Philippines` | `PayMaya Philippines` |
| `Seabank` | `Seabank` |

---

<a id="ynuopay-vn-bank-code"></a>
## 7. Ynuopay - 越南银行编码表

- 商户字段：`payeeBankCode`
- 值域类型：`bankCode`
- 来源：Ynuopay Apifox `越南银行编码表`

### 7.1 在线样例

| `bankCode` | `bankName` |
| --- | --- |
| `VND_ABB` | `ABBANK` |
| `VND_ACB` | `ACB` |
| `VND_BIDV` | `BIDV` |
| `VND_MB` | `MBBank` |
| `VND_VCB` | `Vietcombank` |
| `VND_TPB` | `TPBank` |
| `VND_KBank` | `KBank` |

接入建议：

- 如后台产品已唯一映射上游渠道，可优先依赖后台配置。
- 只有在产品明确要求商户显式指定银行时，再填写 `payeeBankCode`。

<a id="ynuopay-mx-bank-list"></a>
## 8. Ynuopay - 墨西哥银行列表

- 商户字段：`payeeBankCode` + `payeeBankName`
- 值域类型：`bankCode`
- 来源：Ynuopay Apifox `银行列表`

### 8.1 在线样例

| `bankCode` | `bankName` |
| --- | --- |
| `37006` | `BANCOMEXT` |
| `37009` | `BANOBRAS` |
| `40002` | `BANAMEX` |
| `40012` | `BBVA_MEXICO` |
| `40014` | `SANTANDER` |
| `40021` | `HSBC` |
| `40044` | `SCOTIABANK` |
| `40072` | `BANORTE` |

接入建议：

- `payeeAccount` 常见为银行账号或 `CLABE`
- `payeeBankCode` 用来表达银行编码
- `payeeBankName` 同步传银行名称，减少上游人工匹配失败

<a id="ynuopay-bd-transfer-code"></a>
## 9. Ynuopay - 孟加拉 transferCode

- 商户字段：`payeeBankCode`
- 值域类型：`transferCode`
- 常见值：`UAW`、`ROCKET`、`NAGAD`、`BKASH`

说明：

- 这是银行/钱包混合通道码。
- 文档应提示商户“按产品或平台模板传值”，不要写成“随便填银行名称”。

<a id="ynuopay-in-ifsc"></a>
## 10. Ynuopay - 印度 IFSC

- 商户字段：`ifsc`
- 值域类型：`IFSC`
- 来源：商户自行填写

说明：

- 印度 IFSC 是银行识别码，不是银行列表。
- 主文档最合适的展示文案是：`需 IFSC | 商户自填`。

---

<a id="infyric-in-ifsc"></a>
## 11. Infyric - 印度 IFSC

- 商户字段：`ifsc`
- 值域类型：`IFSC`
- 来源：商户自行填写

说明：

- `infyric` 留存资料存在“银行列表”章节，但当前未确认稳定公开链接。
- 因此主文档应保守展示为：`需 IFSC | 商户自填` 或 `需 bankCode | 见附录`。

---

<a id="novavexis-br-pix-bank"></a>
## 12. NovaVexis / Gxppay - 巴西 PIX_BANK

<a id="gxppay-br-pix-bank"></a>

- 商户字段：`payeeBankCode`
- 值域类型：`ISPB`
- 相关字段：`payeeBranchCode`

说明：

- `PIX_BANK` 不是普通银行名场景。
- `payeeBankCode` 实际要传的是巴西银行机构码 `ISPB`。
- `payeeBranchCode` 填上游 `branchBankNo`。
- 主文档适合展示为：`需 ISPB | 见附录`。

---

<a id="fzpay-ph-bank-code"></a>
## 13. Fzpay - 受限银行编码资料

- 当前仓库资料表明，`fzpay` 存在多张国家级银行编码文档，例如：
  - 菲律宾代付银行编码
  - 尼日利亚付银行编码
- 这些资料更适合由平台内部维护，不建议直接在对外主文档公开完整枚举。

主文档建议口径：

- `bankCode | 受限文档`
- `联系平台获取最新编码`

---

<a id="cowpay-bd-bank-code"></a>
## 14. CowPay - bank_code / IFSC

<a id="cowpay-in-ifsc"></a>

### 14.1 孟加拉 / 美国 / 巴基斯坦

- 商户字段：`payeeBankCode`
- 值域类型：`bankCode`

说明：

- `BD`：必填 `bank_code`
- `US`：必填 `bank_code`，值域更接近渠道支持的钱包/账户类型
- `PK`：`bank_code` 可选，但建议传

### 14.2 印度

- 商户字段：`ifsc`
- 值域类型：`IFSC`

说明：

- 上游字段名仍可能叫 `bank_code`
- 但平台对商户统一要求走 `ifsc`

---

<a id="payx-in-ifsc"></a>
## 15. FIXPAY - 受限在线文档枚举

<a id="fixpay-br-pix-type"></a>

### 15.1 巴西 PIX 账号类型

- 商户字段：`payeeBankCode`
- 值域类型：`PIX账号类型`
- 来源：FIXPAY 受限在线文档 `巴西 -> 代付`

在线正文结论：

- `bankCode` 字段说明不是银行编码，而是 `PIX账号类型（CPF、CNPJ、PHONE、EMAIL、EVP）`
- `bankNumber` 实际上传对应的 PIX 标识值

接入建议：

- 主文档不要把这类产品写成“银行列表”。
- 最合适的摘要是：`需 PIX 类型 | 受限文档`。

### 15.2 在线样例

| `payeeBankCode` | 含义 |
| --- | --- |
| `CPF` | 个人税号 |
| `CNPJ` | 企业税号 |
| `PHONE` | 手机号 |
| `EMAIL` | 邮箱 |
| `EVP` | 随机密钥 |

<a id="fixpay-ph-wallet-code"></a>
### 15.3 菲律宾钱包编码

- 商户字段：`payeeBankCode`
- 值域类型：`walletCode`
- 来源：FIXPAY 受限在线文档 `菲律宾 -> 代付`

在线正文结论：

- `bankCode` 字段说明为：`菲律宾 钱包代付银行编号 GRABPAY、GCASH、PAYMAYA`
- 这不是传统银行卡银行表，而是钱包编码枚举

### 15.4 在线样例

| `payeeBankCode` | 含义 |
| --- | --- |
| `GRABPAY` | GrabPay |
| `GCASH` | GCash |
| `PAYMAYA` | PayMaya |

---

<a id="phpay-ph-wallet-type"></a>
<a id="phpay-ph-bank-type"></a>
## 16. Phpay - 菲律宾钱包与银行 type

### 16.1 字段映射

- 钱包类适用账户类型：`GCASH` / `MAYA`
- 银行类适用账户类型：`BANK` / `BANK_CARD` / `PERSONAL_BANK`
- 钱包类商户字段：`payeeType`
- 银行类商户字段：`payeeBankCode`
- 上游字段：`type`
- 来源：[Phpay 在线文档 - 代付银行类型](https://demo.go2okada.com/doc.html#payout-types)

### 16.2 关键说明

- `payeeType` 是平台标准账户类型，商户只传 `GCASH` 或 `MAYA`；平台分别映射上游 `type=GCash`、`type=maya`。
- 银行类代付时，`payeeBankCode` 承载的是 Phpay 上游 `type`，不是平台自定义银行码，也不是银行名称自由文本。
- 在线文档的 `Payout Bank Types` 同时包含传统银行、数字银行、钱包机构和短码，平台按商户传入的 `payeeBankCode` 原样上送。
- 完整静态清单见 [`payout-bank-catalog.html#phpay-ph-bank-type`](./payout-bank-catalog.html#phpay-ph-bank-type)。

### 16.3 钱包 type

| 平台 `payeeType` | 上游 `type` | 是否需要 `payeeBankCode` |
| --- | --- | --- |
| `GCASH` | `GCash` | 否 |
| `MAYA` | `maya` | 否 |

### 16.4 银行/机构 type 样例

| `payeeBankCode` | 银行/机构名称 |
| --- | --- |
| `GW_BDO` | `BDO Unibank, Inc.` |
| `GW_BPI` | `BPI / BPI Family Savings Bank` |
| `GW_UBP` | `Union Bank of the Philippines` |
| `GW_LBP` | `Land Bank of The Philippines` |
| `GW_MET` | `Metropolitan Bank and Trust Co.` |
| `GW_MYA` | `Maya Bank, Inc.` |
| `GW_PPI` | `Maya Philippines, Inc./Maya Wallet` |
| `GXCH` | `G-Xchange Inc. / GCash` |
| `QCDF` | `Queen City Development Bank, Inc.` |
| `rcbc` | `Rizal Commercial Banking Corp.` |

---

<a id="payx-in-ifsc"></a>
## 17. PayX - 印度 IFSC

- 商户字段：`ifsc`
- 值域类型：`IFSC`

说明：

- `PayX` 当前库里既有 `BANK` 也有 `UPI`。
- 只有银行类产品需要 IFSC。
- 专项说明显示其上游字段名和真实语义并不完全一致，因此主文档不要写成“银行名称”。

---

<a id="eqpay-us-ach-routing"></a>
## 18. Eqpay - ACH routing number

- 适用账户类型：`ACH`
- 商户字段：`payeeBankCode`
- 值域类型：`routingNumber`

说明：

- `payeeAccount` 填 `accountNumber`
- `payeeBankCode` 填 `routingNumber`
- 这是银行路由号，不是银行枚举列表

主文档建议口径：

- `需 routingNumber | 商户自填`

---

## 19. 对商户的统一建议

- 看到 `需 bankid` / `需 bankCode` / `需 transferCode` 时，不要填银行名称自由文本。
- 看到 `需 IFSC` / `需 routingNumber` / `需 ISPB` 时，说明这是银行识别码，应按收款银行真实值填写。
- 某些渠道的 `payeeBankCode` 同时覆盖银行和钱包，不要用“银行列表”一词误导商户。
- 对来源受限渠道，优先向平台获取当前模板，不要使用历史截图或旧 Excel 自行猜值。