Guía de validación de IBAN

Validación de IBAN: cómo comprobarlo de forma segura

La validación de IBAN es una comprobación por capas de una cadena emitida por un banco: formato del país, longitud esperada, caracteres permitidos y relación de dígitos MOD-97. Un proceso claro ayuda a encontrar errores de copia sin confundir un formato correcto con una cuenta real.

Esta guía explica cómo validar un IBAN paso a paso, cómo leer los fallos más comunes y cuándo necesitas al banco o al proveedor de pagos. Sirve para operaciones, soporte, pruebas de calidad y desarrollo, donde es importante separar la sintaxis de la verificación de una cuenta.

Ilustración editorial de validación de IBAN que separa formato nacional, longitud y comprobación MOD-97
La validación de IBAN comprueba una cadena estructurada; no es una consulta pública de cuentas.

Qué significa la validación de IBAN

La validación de IBAN comprueba si un número de cuenta bancaria internacional es coherente con el formato registrado de un país. En la práctica pregunta si tiene un prefijo de país plausible, la longitud correcta, caracteres permitidos y dígitos que satisfacen la regla internacional MOD-97. El resultado es útil porque un carácter perdido, una cifra intercambiada o un prefijo incorrecto puede hacer que un formulario rechace el dato antes de que un banco procese el pago.

La palabra validación puede describir varios niveles, por lo que conviene separarlos. Una comprobación de formato no equivale a una consulta bancaria, una coincidencia de nombre, un control de sanciones o una confirmación de que la transferencia llegará. Al documentar el resultado, indica exactamente qué pasó: “formato del país y checksum correctos” es más preciso que “esta es una cuenta válida”. Para introducir un valor y obtener un resultado inmediato usa el comprobador de IBAN; esta página explica cómo interpretar ese proceso y sus límites.

Usa como fuente el valor entregado por el banco. No construyas un IBAN personal a partir de un nombre, una tarjeta, un número local o un ejemplo público. Un generador puede producir datos sintéticos para desarrollo, pero no puede descubrir una cuenta privada. Esta separación protege los pagos reales y evita que los datos de QA terminen en instrucciones de producción.

CapaPregunta que respondeLo que no demuestra
Sintaxis¿El prefijo y los caracteres tienen forma de IBAN?Que la cadena proceda de un banco.
Formato nacional¿El país usa esta longitud y este patrón BBAN?Que todos los campos nacionales estén activos.
MOD-97¿Los dígitos de control coinciden con el resto?Que exista una cuenta o pertenezca al beneficiario.
Verificación autorizada¿El banco o proveedor puede confirmar la relación?Que cualquier ruta y condición garantice el pago.

Las capas de validación: país, longitud, BBAN y MOD-97

Empieza por el código de país. Las dos primeras letras seleccionan una especificación nacional y los dos dígitos siguientes son los dígitos de control internacionales. Todo lo que sigue forma el Basic Bank Account Number, o BBAN. Un BBAN alemán, francés, británico u holandés puede usar posiciones, caracteres y longitudes diferentes. Por eso el comprobador debe elegir la regla del país antes de decidir si el valor parece razonable.

Después compara la longitud del valor normalizado con la longitud registrada. Elimina solo los espacios de presentación, conserva los ceros iniciales y rechaza la puntuación o los caracteres ocultos que el contrato de entrada no admita. Aprobar la longitud es necesario, pero insuficiente: muchos valores erróneos pueden tener el mismo número de caracteres. El patrón BBAN añade otra capa y comprueba si cada posición admite cifras, letras, identificadores bancarios, sucursales o un control nacional.

Por último ejecuta el cálculo MOD-97. Mueve los cuatro primeros caracteres al final, convierte las letras A-Z en valores decimales de 10 a 35 y procesa los dígitos con un resto acumulado. Un IBAN completo suele aprobar cuando el resto final es 1. El checksum detecta muchos errores de transcripción, pero sigue siendo una relación matemática sobre texto.

Diagrama editorial de cuatro pasos para validar un IBAN: normalizar, comprobar país, calcular MOD-97 y confirmar la fuente
Aplica las comprobaciones estructurales en orden y conserva la confirmación bancaria como resultado separado.
  1. Selecciona la regla del paísLee el prefijo de dos letras y carga la longitud y el patrón BBAN registrados.
  2. Normaliza la presentaciónElimina espacios visibles, convierte letras a mayúsculas cuando proceda y rechaza puntuación no admitida.
  3. Comprueba el checksumRota la cadena, expande letras y calcula el resto módulo 97.
  4. Registra el límiteEtiqueta el resultado como validación de formato o checksum, salvo que también exista una comprobación bancaria autorizada.

Cómo validar un IBAN paso a paso

Primero consigue el valor completo de un extracto, una sesión bancaria autenticada, la aplicación oficial o una instrucción de pago verificada. Conserva la presentación original para poder compararla si falla una comprobación. Si el dato llegó en un mensaje que cambia las instrucciones de pago, confírmalo por otro canal de confianza. La validación no detecta todo el fraude: alguien puede enviar una cuenta perfectamente formateada.

Segundo normaliza la entrada según el contrato de la herramienta o del proveedor. Los espacios impresos suelen ser separadores, por lo que un campo electrónico puede quitarlos. No repares caracteres ausentes, no cambies una letra por una cifra parecida y no elimines ceros iniciales. Rechaza una etiqueta “IBAN”, una barra, un guion o un carácter no ASCII salvo que el analizador documente expresamente que los acepta.

Tercero valida por capas y conserva el primer fallo significativo. Si el país no está soportado, no presentes un fallo de checksum como problema principal. Si la longitud no coincide, pide que se copie de nuevo antes de depurar MOD-97. Si el checksum falla después del formato, compara todos los caracteres con la fuente y comprueba si un espacio de impresión o un salto de línea entró como dato. Esta secuencia convierte “IBAN no válido” en una corrección concreta.

  1. 1. Confirma la fuenteUsa una fuente bancaria actual y comprueba nombre de cuenta y moneda.
  2. 2. Normaliza con cuidadoQuita solo espacios de presentación, conserva letras y cifras y rechaza símbolos inesperados.
  3. 3. Aplica la regla nacionalCompara código de país, longitud, clases de caracteres y posiciones BBAN.
  4. 4. Ejecuta MOD-97Usa la cadena completa y espera un resto final de 1 para la coherencia del checksum.
  5. 5. Escala correctamentePregunta al banco o proveedor cuando la decisión necesita algo más que sintaxis.

Cómo leer los resultados de aprobación y error

Un buen validador devuelve un estado explicado, no solo una insignia verde. “País no compatible” indica que el registro no conoce el prefijo o que está mal copiado; no autoriza a sustituir otro país. “Longitud incorrecta” significa que el conteo normalizado no coincide con la especificación. “Caracteres no válidos” suele señalar puntuación, una etiqueta copiada, un espacio no separable o un carácter fuera del alfabeto. Corrige el origen en vez de adivinar.

Un checksum incorrecto significa que la cadena rotada y expandida no dejó el resto esperado. Vuelve a copiar el valor, compara los cuatro primeros caracteres y busca una cifra o letra transpuesta. Un checksum correcto significa que la relación es matemáticamente coherente. No demuestra que la cuenta esté abierta, que el nombre coincida ni que el banco receptor acepte el pago. Esa limitación debe aparecer junto al estado de aprobación.

  • Nunca cambies cifras hasta que el checksum pase; un pase forzado destruye la evidencia del error original.
  • Mantén separados en analítica los fallos de formato nacional y los fallos de checksum.
  • Muestra “formato aceptado” en vez de afirmar que un banco confirmó la cuenta.
ResultadoSignificado probableSiguiente acción
País no compatibleEl prefijo no está en el registro o está mal escrito.Confirma el prefijo bancario y la cobertura del registro.
Longitud incorrectaEl número de caracteres no coincide con la regla nacional.Copia de nuevo el valor; no añadas ceros.
Fallo de patrónUn carácter o campo no coincide con el patrón BBAN.Compara la fuente y las instrucciones del país.
Checksum incorrectoMOD-97 falla después de normalizar.Revisa transcripción, espacios y rotación de cuatro caracteres.
Formato aprobadoLa cadena es coherente bajo las reglas probadas.Usa una verificación bancaria para decisiones de cuenta.

Qué no puede demostrar la validación de IBAN

Un validador de formato puede analizar una cadena sin contactar con un banco. Normalmente detecta caracteres no admitidos, longitud incorrecta, incompatibilidad entre país y BBAN y un checksum MOD-97 fallido. Eso sirve para formularios y limpieza de datos, pero responde a una pregunta técnica limitada. Una cadena puede pasar todas las reglas locales y aun así no estar asignada, estar cerrada, aparecer en el campo equivocado o no servir para la ruta de pago elegida.

La validación tampoco demuestra quién es el titular. No puede inferir el IBAN de una persona a partir de su nombre, tarjeta, dirección o cuenta local parcial. No hace coincidencia de beneficiario, control de sanciones, consulta de saldo ni autorización de pago. Esas decisiones corresponden a un banco o proveedor autorizado con acceso y controles adecuados.

Para una transferencia real, compara el IBAN completo con las instrucciones actuales del banco receptor y confirma por un canal seguro cualquier cambio. Para probar software, usa valores sintéticos identificados y controles de entorno. La guía de datos de prueba IBAN explica cómo mantener fixtures fuera de facturas, beneficiarios, adeudos directos y llamadas de producción.

  • La validez del formato no demuestra que exista una cuenta.
  • El prefijo de país no demuestra dónde vive el titular.
  • Un checksum correcto no demuestra propiedad ni coincidencia del beneficiario.
  • Una comprobación local no es autorización ni garantía de liquidación.

Lista para desarrollo y QA de la validación de IBAN

Implementa la validación como etapas explícitas para que cada consumidor elija la respuesta correcta. Conserva el valor como texto, normaliza solo los caracteres de presentación permitidos y carga las reglas desde un registro mantenido. No conviertas un IBAN completo en un número JavaScript ni en un tipo de coma flotante: las cadenas largas y los ceros iniciales pueden dañarse. Un bucle de módulo progresivo mantiene acotada la aritmética y facilita las pruebas.

Una matriz útil incluye un valor sintético conocido para varias longitudes, el mismo valor con espacios impresos, minúsculas, un carácter cambiado, dos caracteres transpuestos, un prefijo no compatible, una cadena demasiado corta, otra demasiado larga, puntuación y un caso de límite de dígitos. La discusión de desarrolladores de la investigación recuerda que un analizador debe validar el rango de los dos dígitos, para no aceptar la ambigüedad de `00` o `97`. Verifica este límite contra el registro nacional actual.

Separa estados como `syntax_error`, `country_unsupported`, `length_error`, `pattern_error`, `checksum_error` y `format_pass`. En los registros evita escribir IBAN completos de clientes cuando basta un valor hash o redactado. Para verificar una cuenta real, deriva al banco o proveedor en vez de añadir una petición de red oculta a un comprobador local.

function ibanMod97(input) {
  const value = input.replace(/[ \t\r\n]/g, '').toUpperCase();
  if (!/^[A-Z]{2}[0-9]{2}[A-Z0-9]+$/.test(value)) {
    return {status: 'syntax_error'};
  }
  let remainder = 0;
  for (const character of value.slice(4) + value.slice(0, 4)) {
    const expanded = /[A-Z]/.test(character)
      ? String(character.charCodeAt(0) - 55)
      : character;
    for (const digit of expanded) {
      remainder = (remainder * 10 + Number(digit)) % 97;
    }
  }
  return {status: remainder === 1 ? 'checksum_pass' : 'checksum_error'};
}

// Comprueba también longitud y BBAN antes de aceptar el resultado.

Este código muestra solo el límite aritmético. Un servicio completo necesita reglas nacionales actualizadas, errores claros, controles de privacidad y una ruta separada para verificar la cuenta con el banco o proveedor.

Elige el siguiente paso después de validar

Si el valor falla, solicita una copia nueva al titular o al banco. No uses un ejemplo público como plantilla de reparación y no cambies caracteres hasta que una herramienta se ponga en verde. Si pasa y la tarea es QA, guárdalo como fixture sintético con una etiqueta de entorno. Si es un pago real, sigue las instrucciones del banco receptor y cualquier control autorizado del proveedor.

El sitio separa estas tareas. Usa el comprobador de IBAN para formato y checksum, el decodificador de IBAN para ver campos, y la guía MOD-97 para la fórmula. Si necesitas un valor emitido por un banco, consulta cómo encontrar tu IBAN en lugar de generarlo.

  1. Formato aprobado para documentaciónRegistra la regla nacional, la versión del registro y la normalización aplicada.
  2. Fixture de QAMarca el valor como sintético y mantenlo fuera de datos de clientes y pagos.
  3. Pago realConfirma los datos emitidos por el banco y usa el canal de verificación del proveedor.

Preguntas frecuentes sobre la validación de IBAN

¿Qué comprueba la validación de IBAN?

Puede comprobar sintaxis, país, longitud registrada, caracteres BBAN y la relación MOD-97. Las capas exactas dependen del registro y del proveedor.

¿Un IBAN válido significa que existe la cuenta?

No. El formato y el checksum son pruebas matemáticas. No demuestran asignación bancaria, estado, titularidad, coincidencia del beneficiario ni posibilidad de pago.

¿Cómo valido un IBAN antes de pagar?

Empieza con el valor del banco, compara cuenta y pago, ejecuta una comprobación de formato y checksum y usa al banco o proveedor cuando necesites confirmación de cuenta.

¿Puedo validar un IBAN con un nombre o una tarjeta?

No. No derives datos bancarios privados de un nombre, tarjeta o cuenta parcial. Pide el valor al banco o usa un canal autenticado.

¿Qué hago si falla el checksum?

Copia de nuevo, elimina solo espacios de presentación, compara los cuatro primeros y los últimos caracteres y pide un valor nuevo. No edites cifras para forzar un pase.

¿Un comprobador de IBAN equivale a una verificación bancaria?

No. El comprobador analiza cadena y formato; la verificación usa un servicio autorizado para confirmar una relación de cuenta según sus reglas.

Lista segura para validar un IBAN

Valida por capas: usa una fuente confiable, normaliza los espacios, selecciona la regla del país, comprueba longitud y caracteres BBAN y ejecuta MOD-97. Indica el estado exacto y deja los fallos listos para corregir.

Un resultado aprobado significa que la cadena es coherente bajo las reglas probadas. No demuestra que exista una cuenta, quién la posee ni que el pago se liquide. Para esas decisiones usa al banco o a un proveedor autorizado.

Referencias de formato e implementación