Valide los números IBAN con una llamada API
Valide cualquier IBAN, extraiga el código de país y los dígitos de control, y recupere una cadena formateada. Una solicitud POST, más de 80 países, no se requiere SDK bancario.
Su forma de pago acepta transferencias bancarias internacionales. El usuario escribe un IBAN de 22 caracteres. Antes de enviar eso a su procesador de pagos y esperar a que falle, desea detectar errores tipográficos. a nivel de forma. La validación del IBAN implica un algoritmo de dígitos de control de módulo 97, específico del país reglas de longitud y análisis de estructura BBAN. Puedes escribirlo tú mismo, buscarlo en una biblioteca o dejar que una API lo maneja.
botoi's /v1/validate/iban El punto final toma una cadena IBAN y devuelve si es
válido, el código del país, el nombre del país y una versión formateada del número. Una publicación
solicitud, sin SDK bancario, sin colección de expresiones regulares que mantener.
La llamada API
Respuesta:
La respuesta le proporciona cuatro campos. valid es el booleano que necesitas para
puerta a nivel de forma. country_code y country te permite detectar automáticamente
el país del banco del usuario para la lógica posterior, como la selección de moneda o las normas fiscales.
formatted devuelve el IBAN en la agrupación estándar de cuatro caracteres humanos
espere ver en facturas y extractos bancarios.
Cuando el IBAN no pasa la verificación del dígito de control, aún obtendrás los campos analizados:
La valid: false La bandera es todo lo que necesitas. No hay excepciones que detectar, ni códigos de error
para mirar hacia arriba. Verifique el booleano y muestre un mensaje de error.
Nodo.js
Pitón
Formatos IBAN por país
La longitud del IBAN varía según el país. Los dos primeros caracteres son siempre el código de país ISO 3166-1, seguido de dos dígitos de control y luego el número de cuenta bancaria básica (BBAN). Aquí están los cinco más Formatos comunes en los pagos europeos:
| País | Código | Longitud | Formato | Ejemplo |
|---|---|---|---|---|
| Alemania | DE | 22 | DE + 2 dígitos de control + 8 códigos bancarios + 10 cuentas | DE89 3704 0044 0532 0130 00 |
| Reino Unido | ES | 22 | GB + 2 dígitos de control + 4 bancos + 6 códigos de clasificación + 8 cuentas | GB29 NWBK 6016 1331 9268 19 |
| Francia | FR | 27 | FR + 2 dígitos de control + 10 banco + 11 cuenta + 2 clave | FR76 3000 6000 0112 3456 7890 189 |
| España | ES | 24 | ES + 2 dígitos de control + 4 banco + 4 sucursal + 2 control + 10 cuenta | ES91 2100 0418 4502 0005 1332 |
| Países Bajos | Países Bajos | 18 | NL + 2 dígitos de control + 4 bancarios + 10 cuentas | NL91 ABNA 0417 1643 00 |
La API maneja los más de 80 países en el registro SWIFT IBAN. No es necesario mantener un tabla de búsqueda de longitudes y formatos; El punto final se valida según las reglas correctas para cada código de país.
Validación de formulario React/Preact en desenfoque
La integración más común: validar el IBAN cuando el usuario sale del campo de entrada. Activar el desenfoque (en lugar de cada pulsación de tecla) mantiene bajo el uso de API y evita el parpadeo mensajes de error mientras el usuario todavía está escribiendo.
El componente llama a la API cuando el campo pierde el foco. Si el IBAN es válido, pasa el
datos analizados (código de país, cadena formateada) hasta el formulario principal a través de onValidated.
Luego, el padre puede completar automáticamente la moneda, ajustar la ruta o mostrar el IBAN formateado como
confirmación.
Validar por lotes los IBAN desde un CSV
Los equipos de finanzas a menudo necesitan validar una lista de IBAN de proveedores o empleados antes de ejecutar una pago por lotes. Este script lee un CSV, valida cada IBAN y marca entradas no válidas.
El script sale con el código 1 si algún IBAN no es válido, lo que lo hace utilizable como paso CI o verificación previa a la carga. Para archivos grandes (más de 1000 filas), agregue un pequeño retraso entre solicitudes o utilice una clave API para obtener límites de tasas más altos.
Incorporación de Stripe Connect
Al incorporar vendedores o autónomos a través de Stripe Connect, recopilas sus datos bancarios para
configurar pagos. Validar el IBAN antes de llamar stripe.accounts.createExternalAccount
evita un viaje de ida y vuelta a la API de Stripe que fallaría de todos modos. También te permite extraer el
código de país para establecer la moneda de pago correcta.
El flujo es sencillo: validar primero, extraer el país, asignarlo a una moneda y luego crear la cuenta externa. Si el IBAN no es válido, el usuario ve inmediatamente un error de esperar a que Stripe lo rechace segundos después.
Puntos clave
-
Un POST, cuatro campos. Enviar una cadena IBAN a
/v1/validate/ibany recupere la validez, el código de país, el nombre del país y el número formateado. - Más de 80 países. El punto final cubre todos los países del registro SWIFT IBAN. No hay ninguna lógica específica de país por su parte.
- Detecte errores a nivel de formulario. Valida en desenfoque en tu formulario de pago para Evite que IBAN no válidos lleguen a su banco o procesador de pagos.
- Sin almacenamiento, sin registro. El IBAN se procesa en memoria y se descarta. No persiste nada.
- Nivel gratuito disponible. Acceso anónimo a 5 solicitudes por minuto, 100 por día. No se requiere clave API para el desarrollo y las pruebas.
FAQ
- ¿Esta API verifica que la cuenta bancaria existe?
- No. Valida la estructura IBAN y la suma de comprobación del módulo 97. Confirma que el número tiene el formato correcto, pero no se comunica con ningún banco ni verifica si la cuenta está abierta o con fondos.
- ¿Cuántos países admite la validación del IBAN?
- Más de 80 países que han adoptado el estándar IBAN, incluidos todos los estados miembros de la UE/EEE, el Reino Unido, Suiza, Arabia Saudita y Brasil. La lista completa sigue el registro SWIFT IBAN.
- ¿Puedo enviar un IBAN con espacios?
- Sí. Los espacios se eliminan automáticamente antes de la validación. "DE89 3704 0044 0532 0130 00" y "DE89370400440532013000" devuelven el mismo resultado.
- ¿Necesito una clave API para validar los IBAN?
- No. El acceso anónimo permite 5 solicitudes por minuto con limitación de velocidad basada en IP y 100 solicitudes por día. Para obtener un mayor rendimiento, regístrese para obtener una clave API en botoi.com/api.
- ¿Está la IBAN que envío almacenada o registrada?
- No. El IBAN se valida en memoria y se descarta inmediatamente. Nada persiste ni se escribe en ningún registro.
Empieza a construir con botoi
150+ endpoints de API para consultas, procesamiento de texto, generacion de imagenes y utilidades para desarrolladores. Plan gratuito, sin tarjeta de credito.