Obtener plantillas de métodos de pago

GET

payments

templates

curl --request GET \
  --url https://api-test.velafi.com/v2/payments/templates \
  --header 'X-BH-TOKEN: <api-key>'

const options = {method: 'GET', headers: {'X-BH-TOKEN': '<api-key>'}};

fetch('https://api-test.velafi.com/v2/payments/templates', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "code": 123,
  "msg": "<string>",
  "data": {}
}

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

GET https://api.velafi.com/v2/payments/templates

Usa https://api-test.velafi.com/v2/payments/templates para pruebas en sandbox.

Parámetros de la solicitud

integer

requerido

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

integer

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

string

Mensaje de respuesta legible, por ejemplo "SUCCESS".

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

curl -X GET "https://api.velafi.com/v2/payments/templates?paymentId=105" \
  -H "X-BH-TOKEN: YOUR_TOKEN"

{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "Account Type": "",
    "Account Number": "",
    "Beneficiary Name": "",
    "Bank Code": ""
  }
}

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.

curl -X GET "https://api.velafi.com/v2/payments/templates?paymentId=72" \
  -H "X-BH-TOKEN: YOUR_TOKEN"

{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "Account Type": "",
    "Full Name": "",
    "Bank Code": "",
    "Bank Account Number": ""
  }
}

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.

curl -X GET "https://api.velafi.com/v2/payments/templates?paymentId=63" \
  -H "X-BH-TOKEN: YOUR_TOKEN"

{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "CVU/CBU Number": "",
    "cuit": "",
    "Bank name": ""
  }
}

curl -X GET "https://api.velafi.com/v2/payments/templates?paymentId=137" \
  -H "X-BH-TOKEN: YOUR_TOKEN"

{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "cuit": "",
    "cvu/cbu": ""
  }
}

curl -X GET "https://api.velafi.com/v2/payments/templates?paymentId=85" \
  -H "X-BH-TOKEN: YOUR_TOKEN"

{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "Bank Name": "",
    "Account Owner Name": "",
    "Account Owner Type": "",
    "Bank Country/Region": "",
    "Account Number": "",
    "Bic": "",
    "firstName": "",
    "lastName": "",
    "businessName": ""
  }
}

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.

curl -X GET "https://api.velafi.com/v2/payments/templates?paymentId=81" \
  -H "X-BH-TOKEN: YOUR_TOKEN"

{
  "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": ""
  }
}

Bank Country/Region usa códigos ISO 3166-1. State usa códigos ISO 3166-2 (por ejemplo, US-CA).

curl -X GET "https://api.velafi.com/v2/payments/templates?paymentId=68" \
  -H "X-BH-TOKEN: YOUR_TOKEN"

{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "Account Type": "",
    "Full Name": "",
    "ID Document Type": "",
    "ID Document Number": "",
    "Bank Code": "",
    "Bank Account Number": ""
  }
}

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.

curl -X GET "https://api.velafi.com/v2/payments/templates?paymentId=90" \
  -H "X-BH-TOKEN: YOUR_TOKEN"

{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "Pix Type": "",
    "Pix Key": ""
  }
}

Enum de Pix Type: CPF (11 dígitos), CNPJ (14 dígitos), EMAIL, PHONE (10–11 dígitos), RANDOM_KEY (con -).

curl -X GET "https://api.velafi.com/v2/payments/templates?paymentId=120" \
  -H "X-BH-TOKEN: YOUR_TOKEN"

{
  "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.

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

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

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

Argentina — 3.0 Transfer (QR) (137)

Clave	`indexCode`	Obligatorio	Valor
`cvu/cbu`	`cvu`	Obligatorio	Texto
`cuit`	`cuit`	Obligatorio	Texto

Brasil — Pix (Genial) (90)

Clave	`indexCode`	Obligatorio	Valor
`Pix Type`	—	Obligatorio	Lista desplegable: un `code` de opción
`Pix Key`	—	Obligatorio	Texto

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

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

Colombia — Bre-B (69)

Clave	`indexCode`	Obligatorio	Valor
`Breb Key`	`brebKey`	Obligatorio	Texto
`Email`	`email`	Opcional	Texto
`Phone Number`	`phone`	Opcional	Texto

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

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

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

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

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

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

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

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

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

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

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

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

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

Manual — ACH/WIRE (56)

Clave	`indexCode`	Obligatorio	Valor
`Account Details`	—	Obligatorio	Texto

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

Manual — Bank Transfer (Chile) (60)

Clave	`indexCode`	Obligatorio	Valor
`Bank name`	—	Obligatorio	Texto
`RUT`	—	Obligatorio	Texto
`Account type`	—	Obligatorio	Texto
`Account number`	—	Obligatorio	Texto

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

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)

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

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

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`)

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

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

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

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

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

⌘I

Obtener plantillas de métodos de pago

curl --request GET \
  --url https://api-test.velafi.com/v2/payments/templates \
  --header 'X-BH-TOKEN: <api-key>'

const options = {method: 'GET', headers: {'X-BH-TOKEN': '<api-key>'}};

fetch('https://api-test.velafi.com/v2/payments/templates', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "code": 123,
  "msg": "<string>",
  "data": {}
}

Descripción general

Cuenta

Configuración

Comercios

Billetera cripto

Beneficiarios

Cotizaciones

Órdenes

Webhooks

Obtener plantillas de métodos de pago

Endpoint

Parámetros de la solicitud

IDs de métodos de pago

Campos de la respuesta

Ejemplos de solicitudes y respuestas

Campos del beneficiario por método de pago

Referencia: tablas de códigos de banco

​Endpoint

​Parámetros de la solicitud

​IDs de métodos de pago

​Campos de la respuesta

​Ejemplos de solicitudes y respuestas

​Campos del beneficiario por método de pago

​Referencia: tablas de códigos de banco

Endpoint

Parámetros de la solicitud

IDs de métodos de pago

Campos de la respuesta

Ejemplos de solicitudes y respuestas

Campos del beneficiario por método de pago

Referencia: tablas de códigos de banco