Códigos de banco
Códigos de banco
El campo bank de customer_data — y el parámetro bank de un enlace universal — llevan el
código del banco: exactamente 3 dígitos, sin el cero inicial.
El cero es el error más común
El código que aparece en tu estado de cuenta lleva cuatro dígitos y empieza por cero. El que va aquí es ese mismo, sin el cero:
| En tu estado de cuenta | En la API | Banco |
|---|---|---|
0134 | 134 | Banesco |
0102 | 102 | Banco de Venezuela |
0191 | 191 | Banco Nacional de Crédito |
Mandarlo con el cero (0134) devuelve un error 400 que te dice esto mismo. No lo corregimos
solos: quitarle dígitos a un código que no entendemos es adivinar a qué banco le domicilias.
No todos los códigos sirven para prellenar
El formulario de checkout dibuja una tarjeta por banco, con su logo. Un banco sin logo no aparece en el formulario, así que prellenarlo dejaría el campo puesto en algo que la persona no ve, no puede quitar y se envía igual.
Por eso solo sirven los bancos activos y con logo. Si mandas cualquier otro, ese campo se ignora, la sesión se crea igual y la persona elige su banco a mano. No es un error, porque un banco puede dejar de servir después de que escribiste la llamada.
Hoy son bastantes menos de los que existen. No supongas que el banco que quieres está disponible: compruébalo antes con la llamada de abajo.
La lista al día
curl -X GET "https://api.venflow.app/banks?status=active"Es una llamada pública: no lleva Api-Key ni Organization.
{
"data": [
{
"id": "134",
"name": "Banesco",
"active": true,
"imageUrl": "https://venflow-public-resources.s3.us-east-1.amazonaws.com/banks/...png"
},
{
"id": "102",
"name": "Banco de Venezuela",
"active": true
}
],
"count": 23
}El id es lo que va en bank. Y la regla completa es esta: sirve el banco que tenga
active: true y además traiga imageUrl. En el ejemplo de arriba, 134 sirve y 102 no.
Esta es la única fuente confiable. Cualquier lista de códigos escrita a mano — incluida una tabla en una documentación — envejece en cuanto se activa o se desactiva un banco.