> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velafi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 获取支付方式模板

> 获取任意支付方式所需的字段模板。添加新收款人时，将返回的键用作 fieldJson 的键。

添加收款人之前，请调用此接口以确切了解某个支付方式需要哪些字段。传入数字 `paymentId` 后，API 会返回一个对象，其键直接对应你在创建收款人时要提交的 `fieldJson`。不同地区的模板差异很大 —— 墨西哥 SPEI 付款需要 CLABE 和账户类型，阿根廷 CVU 付款需要 CVU/CBU 号码和 CUIT，而 SEPA 转账则需要 IBAN 格式的账号以及账户持有人信息。

## 接口地址

```text theme={null}
GET https://api.velafi.com/v2/payments/templates
```

> [!NOTE]
>
> 在沙盒环境中测试时，请使用 `https://api-test.velafi.com/v2/payments/templates`。

## 请求参数

**paymentId** `integer` *required*

支付方式的数字 ID。所有支持的取值请参见下方的支付方式 ID 表。

## 支付方式 ID

下表列出了所有支持的支付方式。请将 **Payment ID** 列的值用作 `paymentId` 查询参数。

| Payment ID | 名称 | 类型 | 通道 |
| - | - | - | - |
| 105 | SPEI (Finco Pay) | 自动 | CLABE – FINCO PAY |
| 72 | SPEI (Tesored) | 自动 | CLABE – TESORED |
| 63 *(sandbox: 18)* | CBU/CVU (Momentum) | 自动 | CVU – Momentum |
| 137 | 3.0 Transfer (QR) | 自动 | QR Argentina |
| 81 *(sandbox: 532)* | ACH Reference – Lead Bank | 自动 | Lead Bank |
| 82 *(sandbox: 533)* | ACH Virtual – Lead Bank | 自动 | Lead Bank |
| 83 *(sandbox: 534)* | FedWire Reference – Lead Bank | 自动 | Lead Bank |
| 84 *(sandbox: 535)* | FedWire Virtual – Lead Bank | 自动 | Lead Bank |
| 85 | SEPA (Bridge) | 自动 | Lead Bank |
| 90 | Pix (Genial) | 自动 | BANCO GENIAL |
| 92 | Pix – Woovi | 自动 | Avenia |
| 95 | 银行转账 | 自动 | PEN 账户 |
| 120 | Wire (CPN)，仅限付款 | 自动 | Circle Payment Network |
| 122 | FPS (CPN)，仅限付款 | 自动 | Circle Payment Network |
| 123 | CHATS (CPN)，仅限付款 | 自动 | Circle Payment Network |
| 124 | SEPA (CPN)，仅限付款 | 自动 | Circle Payment Network |
| 125 | BANK-TRANSFER (CPN)，仅限付款 | 自动 | Circle Payment Network |
| 127 | FEDWIRE (CPN)，仅限付款 | 自动 | Circle Payment Network |
| 106 | Wire (HK Trade Payouts)，仅限付款 | 自动 | — |
| 68 | Automatic ACH | 自动 | COP 账户 |
| 69 | Bre-B | 自动 | COP 账户 |
| 141 | PSE，仅限收款 | 自动 | COP 账户 |
| 142 | BanColombia，仅限收款 | 自动 | COP 账户 |
| 143 | Nequi，仅限收款 | 自动 | COP 账户 |
| 144 | QR Bre-B，仅限收款 | 自动 | COP 账户 |
| 70 | VelaFi Pending Fund | 自动 | — |
| 27 | 银行转账（巴西） | 手动 | — |
| 28 | 银行转账（阿根廷） | 手动 | — |
| 48 | 银行转账（哥伦比亚） | 手动 | — |
| 56 | Manual ACH/WIRE | 手动 | — |
| 59 | Manual ACH – Perú | 手动 | — |
| 60 | 银行转账（智利） | 手动 | — |
| 61 | Manual USD Payments (CHATS) | 手动 | — |
| 62 | Bridge | 手动 | — |
| 89 | SEPA | 手动 | — |
| 103 | SEPA | 手动 | — |
| 500 | 银行转账（玻利维亚，手动） | 手动 | — |
| 501 | WIRE (HK TRADE PAYIN) | 手动 | — |
| 503 | Manual CNY Payout | 手动 | — |
| 504 | Manual Global USD Payout | 手动 | — |
| 505 | TED | 手动 | — |

## 响应字段

**code** `integer`

响应状态码。`200` 表示成功。

**msg** `string`

可读的响应信息，例如 `"SUCCESS"`。

**data** `object`

必填模板字段的键值映射。键为字段名；值为空字符串，表示添加收款人时需要填写的内容。

## 请求与响应示例

> [tab] 墨西哥 SPEI – Finco Pay (105)
>
> ```bash theme={null}
> curl -X GET "https://api.velafi.com/v2/payments/templates?paymentId=105" \
>   -H "X-BH-TOKEN: YOUR_TOKEN"
> ```
>
> ```json theme={null}
> {
>   "code": 200,
>   "msg": "SUCCESS",
>   "data": {
>     "Account Type": "",
>     "Account Number": "",
>     "Beneficiary Name": "",
>     "Bank Code": ""
>   }
> }
> ```
>
> > [!NOTE]
> >
> > `Account Type` 必须为 `clabe`（虚拟账户）或 `debit`（银行卡账户）。仅当 `Account Type` 为 `debit` 时才需要 `Bank Code`。请参见下方的墨西哥 FINCO PAY 银行代码部分。

> [tab] 墨西哥 SPEI – Tesored (72)
>
> ```bash theme={null}
> curl -X GET "https://api.velafi.com/v2/payments/templates?paymentId=72" \
>   -H "X-BH-TOKEN: YOUR_TOKEN"
> ```
>
> ```json theme={null}
> {
>   "code": 200,
>   "msg": "SUCCESS",
>   "data": {
>     "Account Type": "",
>     "Full Name": "",
>     "Bank Code": "",
>     "Bank Account Number": ""
>   }
> }
> ```
>
> > [!NOTE]
> >
> > `Account Type` 必须为 `clabe` 或 `spei_card`。仅当 `Account Type` 为 `spei_card` 时才需要 `Bank Code`。请参见下方的墨西哥 TESORED 银行代码部分。

> [tab] 阿根廷 CVU/CBU (63)
>
> ```bash theme={null}
> curl -X GET "https://api.velafi.com/v2/payments/templates?paymentId=63" \
>   -H "X-BH-TOKEN: YOUR_TOKEN"
> ```
>
> ```json theme={null}
> {
>   "code": 200,
>   "msg": "SUCCESS",
>   "data": {
>     "CVU/CBU Number": "",
>     "cuit": "",
>     "Bank name": ""
>   }
> }
> ```

> [tab] 阿根廷 QR (137)
>
> ```bash theme={null}
> curl -X GET "https://api.velafi.com/v2/payments/templates?paymentId=137" \
>   -H "X-BH-TOKEN: YOUR_TOKEN"
> ```
>
> ```json theme={null}
> {
>   "code": 200,
>   "msg": "SUCCESS",
>   "data": {
>     "cuit": "",
>     "cvu/cbu": ""
>   }
> }
> ```

> [tab] SEPA Bridge (85)
>
> ```bash theme={null}
> curl -X GET "https://api.velafi.com/v2/payments/templates?paymentId=85" \
>   -H "X-BH-TOKEN: YOUR_TOKEN"
> ```
>
> ```json theme={null}
> {
>   "code": 200,
>   "msg": "SUCCESS",
>   "data": {
>     "Bank Name": "",
>     "Account Owner Name": "",
>     "Account Owner Type": "",
>     "Bank Country/Region": "",
>     "Account Number": "",
>     "Bic": "",
>     "firstName": "",
>     "lastName": "",
>     "businessName": ""
>   }
> }
> ```
>
> > [!NOTE]
> >
> > `Account Owner Type` 必须为 `Business` 或 `Individual`。若为 `Business`，请提供 `businessName`；若为 `Individual`，请同时提供 `firstName` 和 `lastName`。`Bank Country/Region` 使用 ISO 3166-1 代码。

> [tab] Lead Bank ACH/Wire (81–84)
>
> ```bash theme={null}
> curl -X GET "https://api.velafi.com/v2/payments/templates?paymentId=81" \
>   -H "X-BH-TOKEN: YOUR_TOKEN"
> ```
>
> ```json theme={null}
> {
>   "code": 200,
>   "msg": "SUCCESS",
>   "data": {
>     "Bank Name": "",
>     "Account Owner Name": "",
>     "Account Owner Type": "",
>     "Bank Country/Region": "",
>     "Account Number": "",
>     "Routing Number": "",
>     "Street Line1": "",
>     "Street Line2": "",
>     "City": "",
>     "State": "",
>     "Postal Code": "",
>     "firstName": "",
>     "lastName": "",
>     "businessName": ""
>   }
> }
> ```
>
> > [!NOTE]
> >
> > `Bank Country/Region` 使用 ISO 3166-1 代码。`State` 使用 ISO 3166-2 代码（例如 `US-CA`）。

> [tab] 哥伦比亚 Automatic ACH (68)
>
> ```bash theme={null}
> curl -X GET "https://api.velafi.com/v2/payments/templates?paymentId=68" \
>   -H "X-BH-TOKEN: YOUR_TOKEN"
> ```
>
> ```json theme={null}
> {
>   "code": 200,
>   "msg": "SUCCESS",
>   "data": {
>     "Account Type": "",
>     "Full Name": "",
>     "ID Document Type": "",
>     "ID Document Number": "",
>     "Bank Code": "",
>     "Bank Account Number": ""
>   }
> }
> ```
>
> > [!NOTE]
> >
> > `Account Type` 枚举值：`cc`（支票账户）、`ch`（储蓄账户）、`dp`（电子存款）。`ID Document Type` 枚举值：`cc`、`nit`、`ce`、`pa`、`ppt`、`ti`、`rc`、`te`、`die`、`nd`。请参见下方的哥伦比亚银行代码。

> [tab] 巴西 Pix – Genial (90)
>
> ```bash theme={null}
> curl -X GET "https://api.velafi.com/v2/payments/templates?paymentId=90" \
>   -H "X-BH-TOKEN: YOUR_TOKEN"
> ```
>
> ```json theme={null}
> {
>   "code": 200,
>   "msg": "SUCCESS",
>   "data": {
>     "Pix Type": "",
>     "Pix Key": ""
>   }
> }
> ```
>
> > [!NOTE]
> >
> > `Pix Type` 枚举值：`CPF`（11 位数字）、`CNPJ`（14 位数字）、`EMAIL`、`PHONE`（10–11 位数字）、`RANDOM_KEY`（包含 `-`）。

> [tab] Wire CPN (120)
>
> ```bash theme={null}
> curl -X GET "https://api.velafi.com/v2/payments/templates?paymentId=120" \
>   -H "X-BH-TOKEN: YOUR_TOKEN"
> ```
>
> ```json theme={null}
> {
>   "code": 200,
>   "msg": "SUCCESS",
>   "data": {
>     "beneficiaryName": "",
>     "country": "",
>     "stateProvince": "",
>     "city": "",
>     "street": "",
>     "postalCode": "",
>     "dateOfBirth": "",
>     "idNumber": "",
>     "idExpirationDate": "",
>     "useCase": "",
>     "reasonForPayment": "",
>     "bankName": "",
>     "bankCountry": "",
>     "swiftCode": "",
>     "accountNumber": ""
>   }
> }
> ```

## 各支付方式的收款人字段

下表列出每个已启用付款方式定义的 `fieldJson` 键，取自支付方式模板。运行时请以本接口返回的内容为准。

* **键：** 发送 **键** 列中的字段标题。如果字段还有 `indexCode`，也可以改用 `indexCode` 作为键。
* **账户持有人类型（`Business` 或 `Individual`）：** 为 `Business` 时，还需发送 `businessName`；为 `Individual` 时，还需发送 `firstName` 和 `lastName`（两者至少填写一个）。
* **下拉字段：** 发送本接口为该字段返回的某个选项的 `code`。其他值会被拒绝并返回 `-4010`。
* **必填字段：** 缺少必填字段的请求会被拒绝并返回 `-4010`。
* 支付方式 `62`、`89` 和 `103` 未定义 `fieldJson` 字段。

> [accordion] Mexico — SPEI (Finco Pay) (105)
>
> | 键 | `indexCode` | 必填 | 取值 |
> | - | - | - | - |
> | `Account Type` | — | 必填 | 下拉选项：选项的 `code` |
> | `Account Number` | — | 必填 | 数字 |
> | `Beneficiary Name` | — | 必填 | 文本 |
> | `Bank Code` | — | 可选 | 下拉选项：选项的 `code` |

> [accordion] Mexico — SPEI (Tesored) (72)
>
> | 键 | `indexCode` | 必填 | 取值 |
> | - | - | - | - |
> | `Account Type` | `accountType` | 必填 | 下拉选项：选项的 `code` |
> | `Full Name` | `fullName` | 必填 | 文本 |
> | `Bank Code` | `bankCode` | 可选 | 下拉选项：选项的 `code` |
> | `Bank Account Number` | `bankAccountNumber` | 必填 | 字母和数字 |

> [accordion] Argentina — CBU/CVU (Momentum) (63)
>
> | 键 | `indexCode` | 必填 | 取值 |
> | - | - | - | - |
> | `Account Number` | `accountNumber` | 必填 | 文本 |
> | `CUIT` | `cuit` | 必填 | 文本 |
> | `Account Type` | `accountType` | 必填 | 下拉选项：选项的 `code` |

> [accordion] Argentina — 3.0 Transfer (QR) (137)
>
> | 键 | `indexCode` | 必填 | 取值 |
> | - | - | - | - |
> | `cvu/cbu` | `cvu` | 必填 | 文本 |
> | `cuit` | `cuit` | 必填 | 文本 |

> [accordion] Brazil — Pix (Genial) (90)
>
> | 键 | `indexCode` | 必填 | 取值 |
> | - | - | - | - |
> | `Pix Type` | — | 必填 | 下拉选项：选项的 `code` |
> | `Pix Key` | — | 必填 | 文本 |

> [accordion] Brazil — Pix - Woovi (Avenia) (92)
>
> | 键 | `indexCode` | 必填 | 取值 |
> | - | - | - | - |
> | `Pix Type` | `pixType` | 必填 | 下拉选项：选项的 `code` |
> | `Pix Key` | `pixKey` | 必填 | 文本 |

> [accordion] Colombia — Automatic ACH (68)
>
> | 键 | `indexCode` | 必填 | 取值 |
> | - | - | - | - |
> | `Account Type` | — | 必填 | 下拉选项：选项的 `code` |
> | `Full Name` | — | 必填 | 文本 |
> | `ID Document Type` | — | 必填 | 下拉选项：选项的 `code` |
> | `ID Document Number` | — | 必填 | 字母和数字 |
> | `Bank Code` | — | 必填 | 下拉选项：选项的 `code` |
> | `Bank Account Number` | — | 必填 | 字母和数字 |

> [accordion] Colombia — Bre-B (69)
>
> | 键 | `indexCode` | 必填 | 取值 |
> | - | - | - | - |
> | `Breb Key` | `brebKey` | 必填 | 文本 |
> | `Email` | `email` | 可选 | 文本 |
> | `Phone Number` | `phone` | 可选 | 文本 |

> [accordion] Peru — Bank Transfer (95)
>
> | 键 | `indexCode` | 必填 | 取值 |
> | - | - | - | - |
> | `Bank Name` | — | 必填 | 下拉选项：选项的 `code` |
> | `Account Type` | — | 必填 | 下拉选项：选项的 `code` |
> | `Account Number` | — | 必填 | 数字 |
> | `CCI Number` | — | 可选 | 数字 |
> | `Email` | — | 必填 | 文本 |
> | `Identification Type` | — | 必填 | 下拉选项：选项的 `code` |
> | `Identification Number` | — | 必填 | 数字 |
> | `Name` | — | 必填 | 文本 |
> | `Phone Number` | — | 必填 | 数字 |

> [accordion] United States — ACH / FedWire (Lead Bank) (81, 82, 83, 84)
>
> | 键 | `indexCode` | 必填 | 取值 |
> | - | - | - | - |
> | `Bank Name` | — | 必填 | 文本 |
> | `Account Owner Name` | — | 必填 | 文本 |
> | `Account Owner Type` | — | 必填 | `Business` 或 `Individual` |
> | `Bank Country/Region` | — | 必填 | 国家，ISO 3166-1 两位代码（如 `US`） |
> | `Account Number` | — | 必填 | 字母和数字 |
> | `Routing Number` | — | 必填 | 文本 |
> | `Street Line1` | — | 必填 | 文本 |
> | `Street Line2` | — | 可选 | 文本 |
> | `City` | — | 必填 | 文本 |
> | `State` | — | 必填 | 地区，ISO 3166-2（如 `US-CA`） |
> | `Postal Code` | — | 必填 | 文本 |

> [accordion] Europe — SEPA (Bridge) (85)
>
> | 键 | `indexCode` | 必填 | 取值 |
> | - | - | - | - |
> | `Bank Name` | — | 必填 | 文本 |
> | `Account Owner Name` | — | 必填 | 文本 |
> | `Account Owner Type` | — | 必填 | `Business` 或 `Individual` |
> | `Bank Country/Region` | — | 必填 | 国家，ISO 3166-1 两位代码（如 `US`） |
> | `Account Number` | — | 必填 | 字母和数字 |
> | `Bic` | — | 必填 | 文本 |

> [accordion] Circle Payment Network — Wire (120)
>
> | 键 | `indexCode` | 必填 | 取值 |
> | - | - | - | - |
> | `Beneficiary Name` | `beneficiaryName` | 必填 | 文本 |
> | `Nationality` | `country` | 必填 | 国家，ISO 3166-1 两位代码（如 `US`） |
> | `Country of Residence` | `stateProvince` | 必填 | 地区，ISO 3166-2（如 `US-CA`） |
> | `City` | `city` | 必填 | 文本 |
> | `Street` | `street` | 必填 | 文本 |
> | `Postal Code` | `postalCode` | 必填 | 文本 |
> | `Date of Birth / Date of Incorporation` | `dateOfBirth` | 可选 | 日期，`yyyy-MM-dd` |
> | `ID Number / Tax ID` | `idNumber` | 可选 | 文本 |
> | `ID Expiration Date` | `idExpirationDate` | 可选 | 日期，`yyyy-MM-dd` |
> | `Use Case` | `useCase` | 必填 | 下拉选项：选项的 `code` |
> | `Reason For Payment` | `reasonForPayment` | 必填 | 下拉选项：选项的 `code` |
> | `Bank Name` | `bankName` | 必填 | 文本 |
> | `Bank Country` | `bankCountry` | 必填 | 国家，ISO 3166-1 两位代码（如 `US`） |
> | `SWIFT Code` | `swiftCode` | 必填 | 文本 |
> | `Account Number` | `accountNumber` | 必填 | 字母和数字 |

> [accordion] Circle Payment Network — FPS (122)
>
> | 键 | `indexCode` | 必填 | 取值 |
> | - | - | - | - |
> | `Beneficiary Name` | `beneficiaryName` | 必填 | 文本 |
> | `Nationality` | `country` | 必填 | 国家，ISO 3166-1 两位代码（如 `US`） |
> | `Country of Residence` | `stateProvince` | 必填 | 地区，ISO 3166-2（如 `US-CA`） |
> | `City` | `city` | 必填 | 文本 |
> | `Street` | `street` | 必填 | 文本 |
> | `Postal Code` | `postalCode` | 必填 | 文本 |
> | `Date of Birth / Date of Incorporation` | `dateOfBirth` | 可选 | 日期，`yyyy-MM-dd` |
> | `ID Number / Tax ID` | `idNumber` | 可选 | 文本 |
> | `ID Expiration Date` | `idExpirationDate` | 可选 | 日期，`yyyy-MM-dd` |
> | `Use Case` | `useCase` | 必填 | 下拉选项：选项的 `code` |
> | `Reason For Payment` | `reasonForPayment` | 必填 | 下拉选项：选项的 `code` |
> | `Recipient Email` | `recipientEmail` | 必填 | 文本 |
> | `Recipient Phone Number` | `recipientPhoneNumber` | 必填 | 国际电话区号 |
> | `FPS ID` | `fpsId` | 必填 | 文本 |
> | `Bank Code` | `bankCode` | 必填 | 文本 |
> | `Account Number` | `accountNumber` | 必填 | 字母和数字 |

> [accordion] Circle Payment Network — CHATS (123)
>
> | 键 | `indexCode` | 必填 | 取值 |
> | - | - | - | - |
> | `Beneficiary Name` | `beneficiaryName` | 必填 | 文本 |
> | `Nationality` | `country` | 必填 | 国家，ISO 3166-1 两位代码（如 `US`） |
> | `Country of Residence` | `stateProvince` | 必填 | 地区，ISO 3166-2（如 `US-CA`） |
> | `City` | `city` | 必填 | 文本 |
> | `Street` | `street` | 必填 | 文本 |
> | `Postal Code` | `postalCode` | 必填 | 文本 |
> | `Date of Birth / Date of Incorporation` | `dateOfBirth` | 可选 | 日期，`yyyy-MM-dd` |
> | `ID Number / Tax ID` | `idNumber` | 可选 | 文本 |
> | `ID Expiration Date` | `idExpirationDate` | 可选 | 日期，`yyyy-MM-dd` |
> | `Use Case` | `useCase` | 必填 | 下拉选项：选项的 `code` |
> | `Reason For Payment` | `reasonForPayment` | 必填 | 下拉选项：选项的 `code` |
> | `Bank Code` | `bankCode` | 必填 | 文本 |
> | `Bank Name` | `bankName` | 必填 | 文本 |
> | `SWIFT Code` | `swiftCode` | 必填 | 文本 |
> | `Account Number` | `accountNumber` | 必填 | 字母和数字 |
> | `Recipient City` | `recipientCity` | 必填 | 文本 |
> | `Recipient Address Street` | `recipientAddressStreet` | 必填 | 文本 |
> | `Recipient Address City` | `recipientAddressCity` | 必填 | 文本 |
> | `Recipient Address Country` | `recipientAddressCountry` | 必填 | 国家，ISO 3166-1 两位代码（如 `US`） |
> | `Recipient Address State Province` | `recipientAddressStateProvince` | 必填 | 地区，ISO 3166-2（如 `US-CA`） |
> | `Recipient Address Postal Code` | `recipientAddressPostalCode` | 必填 | 文本 |

> [accordion] Circle Payment Network — SEPA (124)
>
> | 键 | `indexCode` | 必填 | 取值 |
> | - | - | - | - |
> | `Beneficiary Name` | `beneficiaryName` | 必填 | 文本 |
> | `Nationality` | `country` | 必填 | 国家，ISO 3166-1 两位代码（如 `US`） |
> | `Country of Residence` | `stateProvince` | 必填 | 地区，ISO 3166-2（如 `US-CA`） |
> | `City` | `city` | 必填 | 文本 |
> | `Street` | `street` | 必填 | 文本 |
> | `Postal Code` | `postalCode` | 必填 | 文本 |
> | `Date of Birth / Date of Incorporation` | `dateOfBirth` | 可选 | 日期，`yyyy-MM-dd` |
> | `ID Number / Tax ID` | `idNumber` | 可选 | 文本 |
> | `ID Expiration Date` | `idExpirationDate` | 可选 | 日期，`yyyy-MM-dd` |
> | `Use Case` | `useCase` | 必填 | 下拉选项：选项的 `code` |
> | `Reason For Payment` | `reasonForPayment` | 必填 | 下拉选项：选项的 `code` |
> | `Bank Name` | `bankName` | 必填 | 文本 |
> | `Bank Country` | `bankCountry` | 必填 | 国家，ISO 3166-1 两位代码（如 `US`） |
> | `SWIFT Code` | `swiftCode` | 必填 | 文本 |
> | `IBAN` | `accountNumber` | 必填 | 文本 |

> [accordion] Circle Payment Network — Bank Transfer (125)
>
> | 键 | `indexCode` | 必填 | 取值 |
> | - | - | - | - |
> | `Beneficiary Name` | `beneficiaryName` | 必填 | 文本 |
> | `Nationality` | `country` | 必填 | 国家，ISO 3166-1 两位代码（如 `US`） |
> | `Country of Residence` | `stateProvince` | 必填 | 地区，ISO 3166-2（如 `US-CA`） |
> | `City` | `city` | 必填 | 文本 |
> | `Street` | `street` | 必填 | 文本 |
> | `Postal Code` | `postalCode` | 必填 | 文本 |
> | `Date of Birth / Date of Incorporation` | `dateOfBirth` | 可选 | 日期，`yyyy-MM-dd` |
> | `ID Number / Tax ID` | `idNumber` | 可选 | 文本 |
> | `ID Expiration Date` | `idExpirationDate` | 可选 | 日期，`yyyy-MM-dd` |
> | `Use Case` | `useCase` | 必填 | 下拉选项：选项的 `code` |
> | `Reason For Payment` | `reasonForPayment` | 必填 | 下拉选项：选项的 `code` |
> | `Bank Name` | `bankName` | 必填 | 文本 |
> | `Bank Country` | `bankCountry` | 必填 | 国家，ISO 3166-1 两位代码（如 `US`） |
> | `SWIFT Code` | `swiftCode` | 必填 | 文本 |
> | `Account Number` | `accountNumber` | 必填 | 字母和数字 |

> [accordion] Circle Payment Network — FEDWIRE (127)
>
> | 键 | `indexCode` | 必填 | 取值 |
> | - | - | - | - |
> | `Beneficiary Name` | `beneficiaryName` | 必填 | 文本 |
> | `Nationality` | `country` | 必填 | 国家，ISO 3166-1 两位代码（如 `US`） |
> | `Country of Residence` | `stateProvince` | 必填 | 地区，ISO 3166-2（如 `US-CA`） |
> | `City` | `city` | 必填 | 文本 |
> | `Street` | `street` | 必填 | 文本 |
> | `Postal Code` | `postalCode` | 必填 | 文本 |
> | `Date of Birth / Date of Incorporation` | `dateOfBirth` | 可选 | 日期，`yyyy-MM-dd` |
> | `ID Number / Tax ID` | `idNumber` | 可选 | 文本 |
> | `ID Expiration Date` | `idExpirationDate` | 可选 | 日期，`yyyy-MM-dd` |
> | `Use Case` | `useCase` | 必填 | 下拉选项：选项的 `code` |
> | `Reason For Payment` | `reasonForPayment` | 必填 | 下拉选项：选项的 `code` |
> | `Bank Name` | `bankName` | 必填 | 文本 |
> | `Bank Country` | `bankCountry` | 必填 | 国家，ISO 3166-1 两位代码（如 `US`） |
> | `Account Number` | `accountNumber` | 必填 | 字母和数字 |
> | `Routing Number` | `routingNumber` | 必填 | 文本 |
> | `Recipient City` | `recipientCity` | 必填 | 文本 |
> | `Recipient Address Street` | `recipientAddressStreet` | 必填 | 文本 |
> | `Recipient Address City` | `recipientAddressCity` | 必填 | 文本 |
> | `Recipient Address Country` | `recipientAddressCountry` | 必填 | 国家，ISO 3166-1 两位代码（如 `US`） |
> | `Recipient Address State Province` | `recipientAddressStateProvince` | 必填 | 地区，ISO 3166-2（如 `US-CA`） |
> | `Recipient Address Postal Code` | `recipientAddressPostalCode` | 必填 | 文本 |

> [accordion] Hong Kong — Wire (HK Trade Payouts) (106)
>
> | 键 | `indexCode` | 必填 | 取值 |
> | - | - | - | - |
> | `Beneficiary Email` | — | 必填 | 文本 |
> | `Supporting Documents` | — | 必填 | 图片：Upload File 返回的 `fileUrl`（多个用逗号分隔） |
> | `Beneficiary Name` | — | 必填 | 文本 |
> | `Account Number` | — | 必填 | 文本 |
> | `Bank Name` | — | 必填 | 文本 |
> | `Swift Code` | — | 必填 | 文本 |

> [accordion] 人工 — Bank Transfer (Brazil) (27)
>
> | 键 | `indexCode` | 必填 | 取值 |
> | - | - | - | - |
> | `Bank name` | — | 必填 | 文本 |
> | `Bank code` | — | 必填 | 文本 |
> | `Branch code` | — | 必填 | 文本 |
> | `Account number` | — | 必填 | 文本 |
> | `CPF/CNPJ` | — | 必填 | 文本 |

> [accordion] 人工 — Bank Transfer (Argentina) (28)
>
> | 键 | `indexCode` | 必填 | 取值 |
> | - | - | - | - |
> | `Account number` | — | 必填 | 文本 |
> | `CBU` | — | 必填 | 数字 |
> | `CUIT/CUIL` | — | 必填 | 文本 |
> | `Email` | — | 可选 | 文本 |
> | `ID` | — | 必填 | 文本 |

> [accordion] 人工 — Bank Transfer (Colombia) (48)
>
> | 键 | `indexCode` | 必填 | 取值 |
> | - | - | - | - |
> | `Número de cuenta` | — | 必填 | 数字 |
> | `Número de identificación` | — | 必填 | 字母和数字 |
> | `Tipo de cuenta` | — | 必填 | 文本 |
> | `Banco` | — | 必填 | 文本 |

> [accordion] 人工 — ACH/WIRE (56)
>
> | 键 | `indexCode` | 必填 | 取值 |
> | - | - | - | - |
> | `Account Details` | — | 必填 | 文本 |

> [accordion] 人工 — ACH (Perú) (59)
>
> | 键 | `indexCode` | 必填 | 取值 |
> | - | - | - | - |
> | `Cuenta` | — | 必填 | 文本 |
> | `Tipo` | — | 必填 | 字母 |
> | `CCI` | — | 必填 | 文本 |
> | `Banco` | — | 必填 | 字母 |
> | `Moneda` | — | 必填 | 字母 |
> | `RUC` | — | 必填 | 文本 |
> | `Real Name` | — | 必填 | 字母 |

> [accordion] 人工 — Bank Transfer (Chile) (60)
>
> | 键 | `indexCode` | 必填 | 取值 |
> | - | - | - | - |
> | `Bank name` | — | 必填 | 文本 |
> | `RUT` | — | 必填 | 文本 |
> | `Account type` | — | 必填 | 文本 |
> | `Account number` | — | 必填 | 文本 |

> [accordion] 人工 — USD Payments (CHATS) (61)
>
> | 键 | `indexCode` | 必填 | 取值 |
> | - | - | - | - |
> | `Account Number` | — | 必填 | 文本 |
> | `Bank Name` | — | 必填 | 文本 |
> | `SWIFT CODE` | — | 可选 | 文本 |
> | `Address` | — | 可选 | 文本 |
> | `Beneficiary Name` | — | 必填 | 文本 |
> | `Beneficiary Tax ID or Registration ID` | — | 必填 | 文本 |

> [accordion] 人工 — Bank Transfer (Bolivia) (500)
>
> | 键 | `indexCode` | 必填 | 取值 |
> | - | - | - | - |
> | `Banco` | — | 可选 | 字母 |
> | `Cuenta` | — | 必填 | 数字 |
> | `NIT` | — | 必填 | 数字 |
> | `Nombre` | — | 必填 | 文本 |
> | `QR` | — | 可选 | 图片：Upload File 返回的 `fileUrl`（多个用逗号分隔） |

> [accordion] 人工 — WIRE (HK Trade Pay-in) (501)
>
> | 键 | `indexCode` | 必填 | 取值 |
> | - | - | - | - |
> | `Beneficiary Name` | — | 必填 | 文本 |
> | `Account Number` | — | 必填 | 数字 |
> | `Beneficiary Address` | — | 必填 | 文本 |
> | `SWIFT CODE` | — | 必填 | 文本 |
> | `Bank Name` | — | 必填 | 文本 |
> | `Bank Code` | — | 必填 | 文本 |
> | `Bank Address` | — | 必填 | 文本 |

> [accordion] 人工 — CNY Payout (503)
>
> | 键 | `indexCode` | 必填 | 取值 |
> | - | - | - | - |
> | `Beneficiary Business Legal Name` | — | 必填 | 文本 |
> | `Beneficiary Business Organization ID Number` | — | 必填 | 文本 |
> | `Beneficiary Business Name in Chinese Hanzi characters` | — | 必填 | 文本 |
> | `Beneficiary Address` | — | 必填 | 文本 |
> | `Beneficiary Account Number` | — | 必填 | 文本 |
> | `Beneficiary Bank and Branch Info` | — | 必填 | 文本 |

> [accordion] 人工 — Global USD Payout (504)
>
> | 键 | `indexCode` | 必填 | 取值 |
> | - | - | - | - |
> | `Beneficiary Name` | — | 必填 | 文本 |
> | `Account Number` | — | 必填 | 文本 |
> | `Beneficiary Address` | — | 必填 | 文本 |
> | `SWIFT CODE` | — | 必填 | 文本 |
> | `Bank Name` | — | 必填 | 文本 |
> | `Bank Code` | — | 可选 | 数字 |
> | `Bank Address` | — | 必填 | 文本 |
> | `Bank Country` | — | 必填 | 国家，ISO 3166-1 两位代码（如 `US`） |

> [accordion] 人工 — TED (Brazil) (505)
>
> | 键 | `indexCode` | 必填 | 取值 |
> | - | - | - | - |
> | `Nome Favorecido` | — | 必填 | 字母 |
> | `Banco/Instituição` | — | 必填 | 字母 |
> | `" Nº Banco/ISPB"` (starts with a space) | — | 必填 | 数字 |
> | `Dados da Conta` | — | 必填 | 文本 |

## 参考：银行代码表

> [accordion] 哥伦比亚银行代码
>
> | 代码 | 银行 | 账户类型 |
> | - | - | - |
> | 1001 | BANCO DE BOGOTA | cc, ch, dp |
> | 1002 | BANCO POPULAR | cc, ch, dp |
> | 1006 | ITAU | cc, ch |
> | 1007 | BANCOLOMBIA | cc, ch, dp |
> | 1009 | CITIBANK | cc, ch |
> | 1012 | BANCO GNB SUDAMERIS | cc, ch |
> | 1013 | BBVA COLOMBIA | cc, ch, dp |
> | 1019 | SCOTIABANK COLPATRIA S.A | cc, ch |
> | 1023 | BANCO DE OCCIDENTE | cc, ch |
> | 1032 | BANCO CAJA SOCIAL BCSC SA | cc, ch |
> | 1040 | BANCO AGRARIO | cc, ch, dp |
> | 1051 | BANCO DAVIVIENDA SA | cc, ch, dp |
> | 1052 | BANCO AV VILLAS | cc, ch, dp |
> | 1061 | BANCOOMEVA | cc, ch, dp |
> | 1066 | BANCO COOPERATIVO COOPCENTRAL | cc, ch, dp |
> | 1067 | MIBANCO S.A. | cc, ch, dp |
> | 1070 | LULO BANK S.A. | ch |
> | 1097 | Dale | dp |
> | 1507 | NEQUI | ch, dp |
> | 1551 | DAVIPLATA | dp |
> | 1558 | BAN100 S.A | cc, ch |
> | 1801 | MOVII | dp |
> | 1809 | NU COLOMBIA | ch |
> | 1811 | RAPPIPAY | ch, dp |

> [accordion] 秘鲁银行代码
>
> | 代码 | 银行 |
> | - | - |
> | 002 | Banco de Crédito del Perú |
> | 003 | Interbank |
> | 009 | Scotiabank Perú S.A.A. |
> | 011 | BBVA Continental Perú |
> | 018 | Banco de la Nación |
> | 023 | Banco de Comercio |
> | 035 | Banco Pichincha |
> | 049 | Mi Banco |
> | 053 | Banco GNB Perú |
> | 055 | Banco Ripley |
> | 056 | Banco Santander Perú |
> | 060 | ICBC Perú Bank |
> | 802 | CMAC Trujillo |
> | 803 | CMAC Arequipa |
> | 805 | CMAC Sullana |
> | 808 | CMAC Huancayo |
> | 921 | LIGO |

> [accordion] 墨西哥 FINCO PAY 银行代码（部分）
>
> | 代码 | 银行 |
> | - | - |
> | cc1cdae0-3091-40b7-80af-681fdf6a9bfd | BANAMEX |
> | e4e7f75c-4f61-4bce-b411-a5509347d755 | BBVA BANCOMER |
> | 0997b675-5230-4752-ae14-cff991d9f6c3 | SANTANDER |
> | 89bfe0b7-ccd2-4f2d-93ef-472a62a1da45 | HSBC |
> | ec7f37e2-4a5d-4df7-9a0d-17200497a603 | BANORTE |
> | 9ded667d-ad5c-4da8-aa85-acf56a14adb7 | NU\_MEXICO |
> | 84e4e446-f7ed-4551-9360-ad39e5a2bf06 | KLAR |
> | 5d4208e6-8c5b-4654-a98a-5e35fef74c2b | MERCADO\_PAGO\_W |

> [accordion] 墨西哥 TESORED 银行代码（部分）
>
> | 代码 | 银行 |
> | - | - |
> | 40002 | Banamex |
> | 40012 | BBVA Mexico |
> | 40014 | Santander |
> | 40021 | HSBC |
> | 40072 | Banorte |
> | 90638 | Nu Mexico |
> | 90722 | Mercado Pago |
> | 90734 | FINCO PAY |


## Related topics

- [获取支持的支付方式](https://docs.velafi.com/cn/api-reference/beneficiary/get-supported-payment-methods.md)
- [获取模板元数据](https://docs.velafi.com/cn/api-reference/beneficiary/get-payment-templates-metamessage.md)
- [管理收款人](https://docs.velafi.com/cn/docs/guides/managing-beneficiaries.md)
- [更新日志](https://docs.velafi.com/cn/docs/changelog.md)
- [获取法币→法币支付方式](https://docs.velafi.com/cn/api-reference/basic-configuration/get-fiat-fiat-payment-methods.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.