Preguntas frecuentes sobre la API de IBAN-Test

La API de IBAN-Test está diseñada para desarrolladores, tiendas, productos SaaS y sistemas internos que necesitan validar automáticamente IBAN, BIC o cuentas bancarias.

Aquí respondemos preguntas sobre tokens Bearer, solicitudes de API, respuestas JSON, cuotas e integraciones habituales. La referencia técnica completa está disponible en la documentación de la API.


¿Cómo se utiliza la API de IBAN-Test?

Ejemplos de API con autenticación Bearer, validación de IBAN y BIC y generación de IBAN.

¿Qué aspecto tiene una solicitud de API?

Utiliza tu token de API como token Bearer en la cabecera HTTP.

Authorization: Bearer TU_TOKEN_DE_API

URL base:

https://www.iban-test.eu/api

Validar un IBAN:

GET /v2/iban/validate/{iban}
curl -H "Authorization: Bearer TU_TOKEN_DE_API" \
  "https://www.iban-test.eu/api/v2/iban/validate/DE89%203704%200044%200532%200130%2000"

Validar un BIC:

GET /v2/bic/validate/{bic}
curl -H "Authorization: Bearer TU_TOKEN_DE_API" \
  "https://www.iban-test.eu/api/v2/bic/validate/COBADEFFXXX"

Validar una cuenta bancaria:

GET /v2/bank-account/validate?bankcode=37040044&accountnumber=532013000

Generar un IBAN:

GET /v2/iban/generate?countrycode=DE&bankcode=37040044&accountnumber=532013000

La referencia técnica completa está disponible en la documentación de la API.

Volver arriba

¿Qué formato de respuesta devuelve la API?

Respuestas JSON con error, código, mensaje y detalles específicos del endpoint.

¿Qué devuelve la API?

Todos los endpoints devuelven JSON. El resultado contiene error, code, message y detalles específicos del endpoint.

{"error":false,"code":2100,"message":"IBAN is valid","details":{}}

Los detalles pueden incluir información bancaria, BIC, resultados de validación de cuentas o datos de IBAN generados, según el endpoint y el país.

Consulta la documentación de la API para conocer los códigos, parámetros y esquemas actuales.

Adeudos SEPA: Core y B2B

La validación del IBAN también devuelve la participación del banco en los esquemas de adeudos SEPA, comprobada en los registros de participantes del EPC.

  • details.sepa.sddCore – Adeudo directo SEPA Core
  • details.sepa.sddB2b – Adeudo directo SEPA B2B

Los dos esquemas se comprueban de forma independiente. confirmed indica una coincidencia inequívoca y vigente en el registro. unknown indica que no se pudo confirmar la participación; no significa que el banco no admita el esquema.

Se comprueba la participación del banco. No se confirma la existencia de la cuenta, su habilitación para adeudos, un mandato ni el éxito de un cobro.

Campos SEPA y ejemplos de respuesta

Volver arriba

¿Por qué está bloqueado mi acceso a la API?

Motivos habituales: cuota agotada, token de API no válido o uso sospechoso.

¿Por qué está bloqueado o desactivado mi acceso a la API?

Puede ocurrir cuando se ha agotado la cuota disponible, el token no es válido o se detecta un uso sospechoso o abusivo.

Si solo has agotado la cuota, puedes esperar al siguiente restablecimiento o cambiar a un paquete con mayor volumen.

Si el bloqueo parece tener otro motivo, ponte en contacto con soporte mediante el formulario de contacto.

Volver arriba

¿Puedo utilizar IBAN-Test en formularios o tiendas?

La API está diseñada para validar IBAN en pagos, registros, mandatos SEPA y procesos administrativos.

Sí. La API de IBAN-Test está diseñada para la validación automatizada en formularios, tiendas, productos SaaS, mandatos SEPA y procesos administrativos.

Los casos habituales incluyen comprobar datos bancarios durante un pago o registro, antes de una domiciliación o antes de importar grandes conjuntos de datos.

Esto ayuda a detectar pronto errores de escritura y datos no válidos, antes de descubrirlos mediante pagos fallidos o domiciliaciones devueltas.

Volver arriba

Validación de datos bancarios

Validación con directorios bancarios de 40 países

Para estos países, comprobamos los IBAN con los directorios bancarios disponibles y, cuando existen, devolvemos datos como la entidad, la ciudad y el BIC.

ALAlbania ADAndorra ATAustria BEBélgica BGBulgaria HRCroacia CYChipre CZRepública Checa DKDinamarca EEEstonia FIFinlandia FRFrancia DEAlemania GIGibraltar GRGrecia HUHungría ISIslandia IEIrlanda ITItalia LVLetonia LILiechtenstein LTLituania LULuxemburgo MTMalta MDMoldavia MEMontenegro NLPaíses Bajos MKMacedonia del Norte NONoruega PLPolonia PTPortugal RORumanía SMSan Marino RSSerbia SKEslovaquia SIEslovenia ESEspaña SESuecia CHSuiza VACiudad del Vaticano

Comprobación de la sintaxis del IBAN

Comprobación de 115 formatos de IBAN

Comprueba que los IBAN tengan una estructura válida, la longitud correcta y una suma de control coherente. Así puedes detectar errores tipográficos y cifras invertidas antes de que falle un pago. Para los países indicados arriba también ofrecemos validación adicional con directorios bancarios reales.

Servidor MCP para agentes de IA - Conecta clientes de IA con las herramientas de validación de IBAN - https://www.iban-test.eu/mcp - Documentación de la API