> ## 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.

# Obtener plantillas de métodos de pago

> Obtén la plantilla de campos obligatorios de cualquier método de pago. Usa las claves devueltas como claves de fieldJson al agregar un nuevo beneficiario.

Antes de agregar un beneficiario, llama a este endpoint para saber exactamente qué campos se requieren para un método de pago determinado. Proporciona el `paymentId` numérico y la API devuelve un objeto cuyas claves corresponden directamente al `fieldJson` que enviarás al crear un beneficiario. Las plantillas varían mucho según la región: un pago por SPEI en México requiere una CLABE y un tipo de cuenta, un pago a CVU en Argentina requiere un número de CVU/CBU y el CUIT, y una transferencia SEPA requiere un número de cuenta tipo IBAN junto con los datos del titular.

## Endpoint

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

> [!NOTE]
>
> Usa `https://api-test.velafi.com/v2/payments/templates` para pruebas en sandbox.

## Parámetros de la solicitud

**paymentId** `integer` *required*

ID numérico del método de pago. Consulta la tabla de Payment ID más abajo para ver todos los valores admitidos.

## IDs de métodos de pago

La tabla siguiente muestra todos los métodos de pago admitidos. Usa el valor de la columna **Payment ID** como parámetro de consulta `paymentId`.

| Payment ID | Nombre | Tipo | Canal |
| - | - | - | - |
| 105 | SPEI (Finco Pay) | Automático | CLABE – FINCO PAY |
| 72 | SPEI (Tesored) | Automático | CLABE – TESORED |
| 63 *(sandbox: 18)* | CBU/CVU (Momentum) | Automático | CVU – Momentum |
| 137 | 3.0 Transfer (QR) | Automático | QR Argentina |
| 81 *(sandbox: 532)* | ACH Reference – Lead Bank | Automático | Lead Bank |
| 82 *(sandbox: 533)* | ACH Virtual – Lead Bank | Automático | Lead Bank |
| 83 *(sandbox: 534)* | FedWire Reference – Lead Bank | Automático | Lead Bank |
| 84 *(sandbox: 535)* | FedWire Virtual – Lead Bank | Automático | Lead Bank |
| 85 | SEPA (Bridge) | Automático | Lead Bank |
| 90 | Pix (Genial) | Automático | BANCO GENIAL |
| 92 | Pix – Woovi | Automático | Avenia |
| 95 | Bank Transfer | Automático | PEN Account |
| 120 | Wire (CPN), solo pagos | Automático | Circle Payment Network |
| 122 | FPS (CPN), solo pagos | Automático | Circle Payment Network |
| 123 | CHATS (CPN), solo pagos | Automático | Circle Payment Network |
| 124 | SEPA (CPN), solo pagos | Automático | Circle Payment Network |
| 125 | BANK-TRANSFER (CPN), solo pagos | Automático | Circle Payment Network |
| 127 | FEDWIRE (CPN), solo pagos | Automático | Circle Payment Network |
| 106 | Wire (HK Trade Payouts), solo pagos | Automático | — |
| 68 | Automatic ACH | Automático | COP Account |
| 69 | Bre-B | Automático | COP Account |
| 141 | PSE, solo cobros (pay-in) | Automático | COP Account |
| 142 | BanColombia, solo cobros (pay-in) | Automático | COP Account |
| 143 | Nequi, solo cobros (pay-in) | Automático | COP Account |
| 144 | QR Bre-B, solo cobros (pay-in) | Automático | COP Account |
| 70 | VelaFi Pending Fund | Automático | — |
| 27 | Bank Transfer (Brazil) | Manual | — |
| 28 | Bank Transfer (Argentina) | Manual | — |
| 48 | Bank Transfer (Colombia) | Manual | — |
| 56 | Manual ACH/WIRE | Manual | — |
| 59 | Manual ACH – Perú | Manual | — |
| 60 | Bank Transfer (Chile) | Manual | — |
| 61 | Manual USD Payments (CHATS) | Manual | — |
| 62 | Bridge | Manual | — |
| 89 | SEPA | Manual | — |
| 103 | SEPA | Manual | — |
| 500 | Bank Transfer (Bolivia Manual) | Manual | — |
| 501 | WIRE (HK TRADE PAYIN) | Manual | — |
| 503 | Manual CNY Payout | Manual | — |
| 504 | Manual Global USD Payout | Manual | — |
| 505 | TED | Manual | — |

## Campos de la respuesta

**code** `integer`

Código de estado de la respuesta. `200` indica éxito.

**msg** `string`

Mensaje de respuesta legible, por ejemplo `"SUCCESS"`.

**data** `object`

Mapa clave-valor de los campos obligatorios de la plantilla. Las claves son los nombres de los campos; los valores son cadenas vacías que indican lo que debes llenar al agregar un beneficiario.

## Ejemplos de solicitudes y respuestas

> [tab] México 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` debe ser `clabe` (cuenta virtual) o `debit` (cuenta de tarjeta). `Bank Code` solo es obligatorio cuando `Account Type` es `debit`. Consulta la sección de códigos de banco de FINCO PAY (México) más abajo.

> [tab] México 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` debe ser `clabe` o `spei_card`. `Bank Code` solo es obligatorio cuando `Account Type` es `spei_card`. Consulta la sección de códigos de banco de TESORED (México) más abajo.

> [tab] Argentina 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] Argentina 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` debe ser `Business` o `Individual`. Si es `Business`, proporciona `businessName`. Si es `Individual`, proporciona tanto `firstName` como `lastName`. `Bank Country/Region` usa códigos 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` usa códigos ISO 3166-1. `State` usa códigos ISO 3166-2 (por ejemplo, `US-CA`).

> [tab] Colombia 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]
> >
> > Enum de `Account Type`: `cc` (cuenta corriente), `ch` (cuenta de ahorro), `dp` (depósito electrónico). Enum de `ID Document Type`: `cc`, `nit`, `ce`, `pa`, `ppt`, `ti`, `rc`, `te`, `die`, `nd`. Consulta los códigos de bancos de Colombia más abajo.

> [tab] Brasil 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]
> >
> > Enum de `Pix Type`: `CPF` (11 dígitos), `CNPJ` (14 dígitos), `EMAIL`, `PHONE` (10–11 dígitos), `RANDOM_KEY` (con `-`).

> [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": ""
>   }
> }
> ```

## Campos del beneficiario por método de pago

Las tablas siguientes muestran las claves de `fieldJson` que define cada método de pago habilitado para dispersiones. Se obtienen de las plantillas de métodos de pago que devuelve este endpoint. En tiempo de ejecución, la respuesta de este endpoint es la fuente autorizada.

* **Clave:** envía el título del campo que aparece en la columna **Clave**. Cuando un campo también tiene un `indexCode`, puedes enviar el `indexCode` como clave en su lugar.
* **Tipo de titular de la cuenta (`Business` o `Individual`):** para `Business`, envía también `businessName`. Para `Individual`, envía también `firstName` y `lastName` (se requiere al menos uno de los dos).
* **Campos de lista desplegable:** envía el `code` de una de las opciones que este endpoint devuelve para el campo. Cualquier otro valor se rechaza con `-4010`.
* **Campos obligatorios:** una solicitud que omite un campo obligatorio se rechaza con `-4010`.
* Los métodos `62`, `89` y `103` no definen campos de `fieldJson`.

> [accordion] México — SPEI (Finco Pay) (105)
>
> | Clave | `indexCode` | Obligatorio | Valor |
> | - | - | - | - |
> | `Account Type` | — | Obligatorio | Lista desplegable: un `code` de opción |
> | `Account Number` | — | Obligatorio | Dígitos |
> | `Beneficiary Name` | — | Obligatorio | Texto |
> | `Bank Code` | — | Opcional | Lista desplegable: un `code` de opción |

> [accordion] México — SPEI (Tesored) (72)
>
> | Clave | `indexCode` | Obligatorio | Valor |
> | - | - | - | - |
> | `Account Type` | `accountType` | Obligatorio | Lista desplegable: un `code` de opción |
> | `Full Name` | `fullName` | Obligatorio | Texto |
> | `Bank Code` | `bankCode` | Opcional | Lista desplegable: un `code` de opción |
> | `Bank Account Number` | `bankAccountNumber` | Obligatorio | Letras y dígitos |

> [accordion] Argentina — CBU/CVU (Momentum) (63)
>
> | Clave | `indexCode` | Obligatorio | Valor |
> | - | - | - | - |
> | `Account Number` | `accountNumber` | Obligatorio | Texto |
> | `CUIT` | `cuit` | Obligatorio | Texto |
> | `Account Type` | `accountType` | Obligatorio | Lista desplegable: un `code` de opción |

> [accordion] Argentina — 3.0 Transfer (QR) (137)
>
> | Clave | `indexCode` | Obligatorio | Valor |
> | - | - | - | - |
> | `cvu/cbu` | `cvu` | Obligatorio | Texto |
> | `cuit` | `cuit` | Obligatorio | Texto |

> [accordion] Brasil — Pix (Genial) (90)
>
> | Clave | `indexCode` | Obligatorio | Valor |
> | - | - | - | - |
> | `Pix Type` | — | Obligatorio | Lista desplegable: un `code` de opción |
> | `Pix Key` | — | Obligatorio | Texto |

> [accordion] Brasil — Pix - Woovi (Avenia) (92)
>
> | Clave | `indexCode` | Obligatorio | Valor |
> | - | - | - | - |
> | `Pix Type` | `pixType` | Obligatorio | Lista desplegable: un `code` de opción |
> | `Pix Key` | `pixKey` | Obligatorio | Texto |

> [accordion] Colombia — Automatic ACH (68)
>
> | Clave | `indexCode` | Obligatorio | Valor |
> | - | - | - | - |
> | `Account Type` | — | Obligatorio | Lista desplegable: un `code` de opción |
> | `Full Name` | — | Obligatorio | Texto |
> | `ID Document Type` | — | Obligatorio | Lista desplegable: un `code` de opción |
> | `ID Document Number` | — | Obligatorio | Letras y dígitos |
> | `Bank Code` | — | Obligatorio | Lista desplegable: un `code` de opción |
> | `Bank Account Number` | — | Obligatorio | Letras y dígitos |

> [accordion] Colombia — Bre-B (69)
>
> | Clave | `indexCode` | Obligatorio | Valor |
> | - | - | - | - |
> | `Breb Key` | `brebKey` | Obligatorio | Texto |
> | `Email` | `email` | Opcional | Texto |
> | `Phone Number` | `phone` | Opcional | Texto |

> [accordion] Perú — Bank Transfer (95)
>
> | Clave | `indexCode` | Obligatorio | Valor |
> | - | - | - | - |
> | `Bank Name` | — | Obligatorio | Lista desplegable: un `code` de opción |
> | `Account Type` | — | Obligatorio | Lista desplegable: un `code` de opción |
> | `Account Number` | — | Obligatorio | Dígitos |
> | `CCI Number` | — | Opcional | Dígitos |
> | `Email` | — | Obligatorio | Texto |
> | `Identification Type` | — | Obligatorio | Lista desplegable: un `code` de opción |
> | `Identification Number` | — | Obligatorio | Dígitos |
> | `Name` | — | Obligatorio | Texto |
> | `Phone Number` | — | Obligatorio | Dígitos |

> [accordion] Estados Unidos — ACH / FedWire (Lead Bank) (81, 82, 83, 84)
>
> | Clave | `indexCode` | Obligatorio | Valor |
> | - | - | - | - |
> | `Bank Name` | — | Obligatorio | Texto |
> | `Account Owner Name` | — | Obligatorio | Texto |
> | `Account Owner Type` | — | Obligatorio | `Business` o `Individual` |
> | `Bank Country/Region` | — | Obligatorio | País, ISO 3166-1 alfa-2 (p. ej., `US`) |
> | `Account Number` | — | Obligatorio | Letras y dígitos |
> | `Routing Number` | — | Obligatorio | Texto |
> | `Street Line1` | — | Obligatorio | Texto |
> | `Street Line2` | — | Opcional | Texto |
> | `City` | — | Obligatorio | Texto |
> | `State` | — | Obligatorio | Región, ISO 3166-2 (p. ej., `US-CA`) |
> | `Postal Code` | — | Obligatorio | Texto |

> [accordion] Europa — SEPA (Bridge) (85)
>
> | Clave | `indexCode` | Obligatorio | Valor |
> | - | - | - | - |
> | `Bank Name` | — | Obligatorio | Texto |
> | `Account Owner Name` | — | Obligatorio | Texto |
> | `Account Owner Type` | — | Obligatorio | `Business` o `Individual` |
> | `Bank Country/Region` | — | Obligatorio | País, ISO 3166-1 alfa-2 (p. ej., `US`) |
> | `Account Number` | — | Obligatorio | Letras y dígitos |
> | `Bic` | — | Obligatorio | Texto |

> [accordion] Circle Payment Network — Wire (120)
>
> | Clave | `indexCode` | Obligatorio | Valor |
> | - | - | - | - |
> | `Beneficiary Name` | `beneficiaryName` | Obligatorio | Texto |
> | `Nationality` | `country` | Obligatorio | País, ISO 3166-1 alfa-2 (p. ej., `US`) |
> | `Country of Residence` | `stateProvince` | Obligatorio | Región, ISO 3166-2 (p. ej., `US-CA`) |
> | `City` | `city` | Obligatorio | Texto |
> | `Street` | `street` | Obligatorio | Texto |
> | `Postal Code` | `postalCode` | Obligatorio | Texto |
> | `Date of Birth / Date of Incorporation` | `dateOfBirth` | Opcional | Fecha, `yyyy-MM-dd` |
> | `ID Number / Tax ID` | `idNumber` | Opcional | Texto |
> | `ID Expiration Date` | `idExpirationDate` | Opcional | Fecha, `yyyy-MM-dd` |
> | `Use Case` | `useCase` | Obligatorio | Lista desplegable: un `code` de opción |
> | `Reason For Payment` | `reasonForPayment` | Obligatorio | Lista desplegable: un `code` de opción |
> | `Bank Name` | `bankName` | Obligatorio | Texto |
> | `Bank Country` | `bankCountry` | Obligatorio | País, ISO 3166-1 alfa-2 (p. ej., `US`) |
> | `SWIFT Code` | `swiftCode` | Obligatorio | Texto |
> | `Account Number` | `accountNumber` | Obligatorio | Letras y dígitos |

> [accordion] Circle Payment Network — FPS (122)
>
> | Clave | `indexCode` | Obligatorio | Valor |
> | - | - | - | - |
> | `Beneficiary Name` | `beneficiaryName` | Obligatorio | Texto |
> | `Nationality` | `country` | Obligatorio | País, ISO 3166-1 alfa-2 (p. ej., `US`) |
> | `Country of Residence` | `stateProvince` | Obligatorio | Región, ISO 3166-2 (p. ej., `US-CA`) |
> | `City` | `city` | Obligatorio | Texto |
> | `Street` | `street` | Obligatorio | Texto |
> | `Postal Code` | `postalCode` | Obligatorio | Texto |
> | `Date of Birth / Date of Incorporation` | `dateOfBirth` | Opcional | Fecha, `yyyy-MM-dd` |
> | `ID Number / Tax ID` | `idNumber` | Opcional | Texto |
> | `ID Expiration Date` | `idExpirationDate` | Opcional | Fecha, `yyyy-MM-dd` |
> | `Use Case` | `useCase` | Obligatorio | Lista desplegable: un `code` de opción |
> | `Reason For Payment` | `reasonForPayment` | Obligatorio | Lista desplegable: un `code` de opción |
> | `Recipient Email` | `recipientEmail` | Obligatorio | Texto |
> | `Recipient Phone Number` | `recipientPhoneNumber` | Obligatorio | Código de marcación internacional |
> | `FPS ID` | `fpsId` | Obligatorio | Texto |
> | `Bank Code` | `bankCode` | Obligatorio | Texto |
> | `Account Number` | `accountNumber` | Obligatorio | Letras y dígitos |

> [accordion] Circle Payment Network — CHATS (123)
>
> | Clave | `indexCode` | Obligatorio | Valor |
> | - | - | - | - |
> | `Beneficiary Name` | `beneficiaryName` | Obligatorio | Texto |
> | `Nationality` | `country` | Obligatorio | País, ISO 3166-1 alfa-2 (p. ej., `US`) |
> | `Country of Residence` | `stateProvince` | Obligatorio | Región, ISO 3166-2 (p. ej., `US-CA`) |
> | `City` | `city` | Obligatorio | Texto |
> | `Street` | `street` | Obligatorio | Texto |
> | `Postal Code` | `postalCode` | Obligatorio | Texto |
> | `Date of Birth / Date of Incorporation` | `dateOfBirth` | Opcional | Fecha, `yyyy-MM-dd` |
> | `ID Number / Tax ID` | `idNumber` | Opcional | Texto |
> | `ID Expiration Date` | `idExpirationDate` | Opcional | Fecha, `yyyy-MM-dd` |
> | `Use Case` | `useCase` | Obligatorio | Lista desplegable: un `code` de opción |
> | `Reason For Payment` | `reasonForPayment` | Obligatorio | Lista desplegable: un `code` de opción |
> | `Bank Code` | `bankCode` | Obligatorio | Texto |
> | `Bank Name` | `bankName` | Obligatorio | Texto |
> | `SWIFT Code` | `swiftCode` | Obligatorio | Texto |
> | `Account Number` | `accountNumber` | Obligatorio | Letras y dígitos |
> | `Recipient City` | `recipientCity` | Obligatorio | Texto |
> | `Recipient Address Street` | `recipientAddressStreet` | Obligatorio | Texto |
> | `Recipient Address City` | `recipientAddressCity` | Obligatorio | Texto |
> | `Recipient Address Country` | `recipientAddressCountry` | Obligatorio | País, ISO 3166-1 alfa-2 (p. ej., `US`) |
> | `Recipient Address State Province` | `recipientAddressStateProvince` | Obligatorio | Región, ISO 3166-2 (p. ej., `US-CA`) |
> | `Recipient Address Postal Code` | `recipientAddressPostalCode` | Obligatorio | Texto |

> [accordion] Circle Payment Network — SEPA (124)
>
> | Clave | `indexCode` | Obligatorio | Valor |
> | - | - | - | - |
> | `Beneficiary Name` | `beneficiaryName` | Obligatorio | Texto |
> | `Nationality` | `country` | Obligatorio | País, ISO 3166-1 alfa-2 (p. ej., `US`) |
> | `Country of Residence` | `stateProvince` | Obligatorio | Región, ISO 3166-2 (p. ej., `US-CA`) |
> | `City` | `city` | Obligatorio | Texto |
> | `Street` | `street` | Obligatorio | Texto |
> | `Postal Code` | `postalCode` | Obligatorio | Texto |
> | `Date of Birth / Date of Incorporation` | `dateOfBirth` | Opcional | Fecha, `yyyy-MM-dd` |
> | `ID Number / Tax ID` | `idNumber` | Opcional | Texto |
> | `ID Expiration Date` | `idExpirationDate` | Opcional | Fecha, `yyyy-MM-dd` |
> | `Use Case` | `useCase` | Obligatorio | Lista desplegable: un `code` de opción |
> | `Reason For Payment` | `reasonForPayment` | Obligatorio | Lista desplegable: un `code` de opción |
> | `Bank Name` | `bankName` | Obligatorio | Texto |
> | `Bank Country` | `bankCountry` | Obligatorio | País, ISO 3166-1 alfa-2 (p. ej., `US`) |
> | `SWIFT Code` | `swiftCode` | Obligatorio | Texto |
> | `IBAN` | `accountNumber` | Obligatorio | Texto |

> [accordion] Circle Payment Network — Bank Transfer (125)
>
> | Clave | `indexCode` | Obligatorio | Valor |
> | - | - | - | - |
> | `Beneficiary Name` | `beneficiaryName` | Obligatorio | Texto |
> | `Nationality` | `country` | Obligatorio | País, ISO 3166-1 alfa-2 (p. ej., `US`) |
> | `Country of Residence` | `stateProvince` | Obligatorio | Región, ISO 3166-2 (p. ej., `US-CA`) |
> | `City` | `city` | Obligatorio | Texto |
> | `Street` | `street` | Obligatorio | Texto |
> | `Postal Code` | `postalCode` | Obligatorio | Texto |
> | `Date of Birth / Date of Incorporation` | `dateOfBirth` | Opcional | Fecha, `yyyy-MM-dd` |
> | `ID Number / Tax ID` | `idNumber` | Opcional | Texto |
> | `ID Expiration Date` | `idExpirationDate` | Opcional | Fecha, `yyyy-MM-dd` |
> | `Use Case` | `useCase` | Obligatorio | Lista desplegable: un `code` de opción |
> | `Reason For Payment` | `reasonForPayment` | Obligatorio | Lista desplegable: un `code` de opción |
> | `Bank Name` | `bankName` | Obligatorio | Texto |
> | `Bank Country` | `bankCountry` | Obligatorio | País, ISO 3166-1 alfa-2 (p. ej., `US`) |
> | `SWIFT Code` | `swiftCode` | Obligatorio | Texto |
> | `Account Number` | `accountNumber` | Obligatorio | Letras y dígitos |

> [accordion] Circle Payment Network — FEDWIRE (127)
>
> | Clave | `indexCode` | Obligatorio | Valor |
> | - | - | - | - |
> | `Beneficiary Name` | `beneficiaryName` | Obligatorio | Texto |
> | `Nationality` | `country` | Obligatorio | País, ISO 3166-1 alfa-2 (p. ej., `US`) |
> | `Country of Residence` | `stateProvince` | Obligatorio | Región, ISO 3166-2 (p. ej., `US-CA`) |
> | `City` | `city` | Obligatorio | Texto |
> | `Street` | `street` | Obligatorio | Texto |
> | `Postal Code` | `postalCode` | Obligatorio | Texto |
> | `Date of Birth / Date of Incorporation` | `dateOfBirth` | Opcional | Fecha, `yyyy-MM-dd` |
> | `ID Number / Tax ID` | `idNumber` | Opcional | Texto |
> | `ID Expiration Date` | `idExpirationDate` | Opcional | Fecha, `yyyy-MM-dd` |
> | `Use Case` | `useCase` | Obligatorio | Lista desplegable: un `code` de opción |
> | `Reason For Payment` | `reasonForPayment` | Obligatorio | Lista desplegable: un `code` de opción |
> | `Bank Name` | `bankName` | Obligatorio | Texto |
> | `Bank Country` | `bankCountry` | Obligatorio | País, ISO 3166-1 alfa-2 (p. ej., `US`) |
> | `Account Number` | `accountNumber` | Obligatorio | Letras y dígitos |
> | `Routing Number` | `routingNumber` | Obligatorio | Texto |
> | `Recipient City` | `recipientCity` | Obligatorio | Texto |
> | `Recipient Address Street` | `recipientAddressStreet` | Obligatorio | Texto |
> | `Recipient Address City` | `recipientAddressCity` | Obligatorio | Texto |
> | `Recipient Address Country` | `recipientAddressCountry` | Obligatorio | País, ISO 3166-1 alfa-2 (p. ej., `US`) |
> | `Recipient Address State Province` | `recipientAddressStateProvince` | Obligatorio | Región, ISO 3166-2 (p. ej., `US-CA`) |
> | `Recipient Address Postal Code` | `recipientAddressPostalCode` | Obligatorio | Texto |

> [accordion] Hong Kong — Wire (HK Trade Payouts) (106)
>
> | Clave | `indexCode` | Obligatorio | Valor |
> | - | - | - | - |
> | `Beneficiary Email` | — | Obligatorio | Texto |
> | `Supporting Documents` | — | Obligatorio | Imagen: `fileUrl` de Upload File (separa varios con comas) |
> | `Beneficiary Name` | — | Obligatorio | Texto |
> | `Account Number` | — | Obligatorio | Texto |
> | `Bank Name` | — | Obligatorio | Texto |
> | `Swift Code` | — | Obligatorio | Texto |

> [accordion] Manual — Bank Transfer (Brazil) (27)
>
> | Clave | `indexCode` | Obligatorio | Valor |
> | - | - | - | - |
> | `Bank name` | — | Obligatorio | Texto |
> | `Bank code` | — | Obligatorio | Texto |
> | `Branch code` | — | Obligatorio | Texto |
> | `Account number` | — | Obligatorio | Texto |
> | `CPF/CNPJ` | — | Obligatorio | Texto |

> [accordion] Manual — Bank Transfer (Argentina) (28)
>
> | Clave | `indexCode` | Obligatorio | Valor |
> | - | - | - | - |
> | `Account number` | — | Obligatorio | Texto |
> | `CBU` | — | Obligatorio | Dígitos |
> | `CUIT/CUIL` | — | Obligatorio | Texto |
> | `Email` | — | Opcional | Texto |
> | `ID` | — | Obligatorio | Texto |

> [accordion] Manual — Bank Transfer (Colombia) (48)
>
> | Clave | `indexCode` | Obligatorio | Valor |
> | - | - | - | - |
> | `Número de cuenta` | — | Obligatorio | Dígitos |
> | `Número de identificación` | — | Obligatorio | Letras y dígitos |
> | `Tipo de cuenta` | — | Obligatorio | Texto |
> | `Banco` | — | Obligatorio | Texto |

> [accordion] Manual — ACH/WIRE (56)
>
> | Clave | `indexCode` | Obligatorio | Valor |
> | - | - | - | - |
> | `Account Details` | — | Obligatorio | Texto |

> [accordion] Manual — ACH (Perú) (59)
>
> | Clave | `indexCode` | Obligatorio | Valor |
> | - | - | - | - |
> | `Cuenta` | — | Obligatorio | Texto |
> | `Tipo` | — | Obligatorio | Letras |
> | `CCI` | — | Obligatorio | Texto |
> | `Banco` | — | Obligatorio | Letras |
> | `Moneda` | — | Obligatorio | Letras |
> | `RUC` | — | Obligatorio | Texto |
> | `Real Name` | — | Obligatorio | Letras |

> [accordion] Manual — Bank Transfer (Chile) (60)
>
> | Clave | `indexCode` | Obligatorio | Valor |
> | - | - | - | - |
> | `Bank name` | — | Obligatorio | Texto |
> | `RUT` | — | Obligatorio | Texto |
> | `Account type` | — | Obligatorio | Texto |
> | `Account number` | — | Obligatorio | Texto |

> [accordion] Manual — USD Payments (CHATS) (61)
>
> | Clave | `indexCode` | Obligatorio | Valor |
> | - | - | - | - |
> | `Account Number` | — | Obligatorio | Texto |
> | `Bank Name` | — | Obligatorio | Texto |
> | `SWIFT CODE` | — | Opcional | Texto |
> | `Address` | — | Opcional | Texto |
> | `Beneficiary Name` | — | Obligatorio | Texto |
> | `Beneficiary Tax ID or Registration ID` | — | Obligatorio | Texto |

> [accordion] Manual — Bank Transfer (Bolivia) (500)
>
> | Clave | `indexCode` | Obligatorio | Valor |
> | - | - | - | - |
> | `Banco` | — | Opcional | Letras |
> | `Cuenta` | — | Obligatorio | Dígitos |
> | `NIT` | — | Obligatorio | Dígitos |
> | `Nombre` | — | Obligatorio | Texto |
> | `QR` | — | Opcional | Imagen: `fileUrl` de Upload File (separa varios con comas) |

> [accordion] Manual — WIRE (HK Trade Pay-in) (501)
>
> | Clave | `indexCode` | Obligatorio | Valor |
> | - | - | - | - |
> | `Beneficiary Name` | — | Obligatorio | Texto |
> | `Account Number` | — | Obligatorio | Dígitos |
> | `Beneficiary Address` | — | Obligatorio | Texto |
> | `SWIFT CODE` | — | Obligatorio | Texto |
> | `Bank Name` | — | Obligatorio | Texto |
> | `Bank Code` | — | Obligatorio | Texto |
> | `Bank Address` | — | Obligatorio | Texto |

> [accordion] Manual — CNY Payout (503)
>
> | Clave | `indexCode` | Obligatorio | Valor |
> | - | - | - | - |
> | `Beneficiary Business Legal Name` | — | Obligatorio | Texto |
> | `Beneficiary Business Organization ID Number` | — | Obligatorio | Texto |
> | `Beneficiary Business Name in Chinese Hanzi characters` | — | Obligatorio | Texto |
> | `Beneficiary Address` | — | Obligatorio | Texto |
> | `Beneficiary Account Number` | — | Obligatorio | Texto |
> | `Beneficiary Bank and Branch Info` | — | Obligatorio | Texto |

> [accordion] Manual — Global USD Payout (504)
>
> | Clave | `indexCode` | Obligatorio | Valor |
> | - | - | - | - |
> | `Beneficiary Name` | — | Obligatorio | Texto |
> | `Account Number` | — | Obligatorio | Texto |
> | `Beneficiary Address` | — | Obligatorio | Texto |
> | `SWIFT CODE` | — | Obligatorio | Texto |
> | `Bank Name` | — | Obligatorio | Texto |
> | `Bank Code` | — | Opcional | Dígitos |
> | `Bank Address` | — | Obligatorio | Texto |
> | `Bank Country` | — | Obligatorio | País, ISO 3166-1 alfa-2 (p. ej., `US`) |

> [accordion] Manual — TED (Brazil) (505)
>
> | Clave | `indexCode` | Obligatorio | Valor |
> | - | - | - | - |
> | `Nome Favorecido` | — | Obligatorio | Letras |
> | `Banco/Instituição` | — | Obligatorio | Letras |
> | `" Nº Banco/ISPB"` (empieza con un espacio) | — | Obligatorio | Dígitos |
> | `Dados da Conta` | — | Obligatorio | Texto |

## Referencia: tablas de códigos de banco

> [accordion] Códigos de bancos de Colombia
>
> | Código | Banco | Tipos de cuenta |
> | - | - | - |
> | 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] Códigos de bancos de Perú
>
> | Código | Banco |
> | - | - |
> | 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] Códigos de banco de FINCO PAY en México (selección)
>
> | Código | Banco |
> | - | - |
> | 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] Códigos de banco de TESORED en México (selección)
>
> | Código | Banco |
> | - | - |
> | 40002 | Banamex |
> | 40012 | BBVA Mexico |
> | 40014 | Santander |
> | 40021 | HSBC |
> | 40072 | Banorte |
> | 90638 | Nu Mexico |
> | 90722 | Mercado Pago |
> | 90734 | FINCO PAY |


## Related topics

- [Listar métodos de pago compatibles](https://docs.velafi.com/es/api-reference/beneficiary/get-supported-payment-methods.md)
- [Obtener metadatos de plantillas](https://docs.velafi.com/es/api-reference/beneficiary/get-payment-templates-metamessage.md)
- [Administrar beneficiarios](https://docs.velafi.com/es/docs/guides/managing-beneficiaries.md)
- [Registro de cambios](https://docs.velafi.com/es/docs/changelog.md)
- [Listar métodos de pago fiat→cripto](https://docs.velafi.com/es/api-reference/basic-configuration/get-fiat-crypto-payment-methods.md)


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