Qué comprueba el checksum MOD 97 del IBAN
Un IBAN combina un código de país de dos letras, dos dígitos de control y una BBAN propia del país. MOD 97 comprueba la relación matemática de control de esa cadena; es un cálculo, no una consulta a un banco ni a una red de pagos.
Mantén separadas la sintaxis, la longitud y el patrón BBAN registrados para el país y la comprobación del checksum. Swift publica el Registro IBAN de ISO 13616 con los formatos nacionales. ISO/IEC 7064 describe sistemas de caracteres de control que ayudan a detectar errores comunes al copiar o teclear.
| Capa | Pregunta que responde | Fallo de ejemplo |
|---|---|---|
| Sintaxis de entrada | ¿Se aceptan estos caracteres y espacios? | Hay una barra, puntuación o símbolo no admitido. |
| Formato del país | ¿Este código usa esta longitud y patrón BBAN? | El código de país aparece con una longitud total incorrecta. |
| Checksum MOD 97 | ¿Los caracteres cumplen la relación de control? | Un carácter cambiado hace que el resto deje de ser 1. |
| Verificación bancaria o del pago | ¿Existe la cuenta y puede recibir este pago? | Hace falta un banco o un servicio autorizado, no MOD 97. |
Checksum IBAN MOD 97: los cuatro pasos del cálculo
Empieza con el IBAN electrónico: elimina los espacios de presentación permitidos y convierte las letras ASCII a mayúsculas, pero rechaza otros signos. Mueve los cuatro primeros caracteres al final y sustituye cada letra de A a Z por su valor decimal del 10 al 35; los dígitos no cambian.
Procesa los dígitos expandidos de izquierda a derecha. Empieza en cero y actualiza resto = (resto × 10 + dígito) mod 97. El valor acumulado siempre está entre 0 y 96, por lo que no hace falta un entero grande. Un resto final de 1 supera la relación de checksum.
- NormalizarQuita los espacios permitidos, pasa las letras ASCII a mayúsculas y rechaza caracteres no admitidos.
- RotarMueve al final del IBAN sus cuatro primeros caracteres.
- Expandir letrasSustituye A–Z por 10–35 y conserva los dígitos decimales.
- Procesar módulo 97Actualiza el resto por cada dígito y acepta el checksum solo si termina en 1.
Ejemplo resuelto: comprobar GB82 WEST 1234 5698 7654 32
Este valor es un ejemplo matemático, no una consulta de cuenta. Al quitar espacios y rotar los cuatro primeros caracteres queda WEST12345698765432GB82. Al convertir W=32, E=14, S=28, T=29, G=16 y B=11 se obtiene 3214282912345698765432161182.
La tabla procesa la cadena por bloques. Cada bloque nuevo se añade al resto anterior según su longitud decimal, sin calcular un entero enorme.
- Conserva los ceros iniciales al leer cada bloque; los bloques son texto para el cálculo, no números de cuenta que debas normalizar.
- El resto final es 1. Esto no demuestra que el valor pertenezca a una cuenta bancaria activa.
| Punto del cálculo | Dígitos procesados | Resto |
|---|---|---|
| Tras el primer bloque | 3214282912 | 23 |
| Añadir los siguientes 10 dígitos | 3456987654 | 58 |
| Añadir los últimos 8 dígitos | 32161182 | 1 |
| Resultado final | 3214282912345698765432161182 mod 97 | Checksum coherente |
Generar los dígitos de control IBAN desde una BBAN
La validación parte de un IBAN completo que ya contiene sus dos dígitos de control. La generación empieza con el código de país y una BBAN que cumple el formato nacional registrado. El checksum no indica qué cuenta o datos bancarios debes usar.
Para calcular los dígitos, forma un valor temporal con el código de país, 00 y la BBAN. Rota sus cuatro primeros caracteres, expande las letras y calcula el resto r módulo 97. Los dígitos son 98 − r, con dos posiciones decimales. Colócalos tras el código de país y valida el IBAN completo: su resto debe ser 1. Para la BBAN GB WEST12345698765432, el valor temporal GB00... deja resto 16; por tanto, 98 − 16 = 82 y se obtiene GB82WEST12345698765432. El cálculo produce dígitos, no datos bancarios verificados.
- Usar la BBAN correctaObtén los campos bancarios según el formato nacional registrado.
- Insertar dígitos provisionalesForma código de país + 00 + BBAN; después rota y expande.
- Calcular dos dígitosResta el resto a 98 y completa con un cero inicial si hace falta.
- Verificar el resultadoInserta los dígitos y confirma que el IBAN completo deja resto 1.
Implementación JavaScript sin crear un entero grande
Esta función comprueba la sintaxis básica y el checksum. Un validador de producción también debe aplicar la longitud y el patrón BBAN vigentes para el país.
function ibanMod97Remainder(input) {
const iban = input.replace(/ /g, "").toUpperCase();
if (!/^[A-Z]{2}[0-9]{2}[A-Z0-9]+$/.test(iban)) {
throw new Error("Sintaxis de IBAN no válida");
}
let remainder = 0;
const rotated = iban.slice(4) + iban.slice(0, 4);
for (const character of rotated) {
const expanded = character >= "A" && character <= "Z"
? String(character.charCodeAt(0) - 55)
: character;
for (const digit of expanded) {
remainder = (remainder * 10 + Number(digit)) % 97;
}
}
return remainder;
}
ibanMod97Remainder("GB82 WEST 1234 5698 7654 32"); // 1
Distingue un fallo de checksum de uno de sintaxis o formato nacional; el código no confirma una cuenta bancaria.
Cálculo progresivo en Python
El mismo bucle con resto acotado funciona en Python. El ejemplo conserva el IBAN como texto y deja las reglas de formato nacional en un registro mantenido.
import re
source = "GB82 WEST 1234 5698 7654 32"
iban = re.sub(r" ", "", source).upper()
if re.fullmatch(r"[A-Z]{2}[0-9]{2}[A-Z0-9]+", iban) is None:
raise ValueError("Sintaxis de IBAN no válida")
rotated = iban[4:] + iban[:4]
remainder = 0
for character in rotated:
expanded = str(ord(character) - 55) if "A" <= character <= "Z" else character
for digit in expanded:
remainder = (remainder * 10 + int(digit)) % 97
print(remainder) # 1
- El ejemplo devuelve 1; el código de producción debe informar por separado de errores de análisis y de checksum.
Mantén el cálculo del checksum como una unidad que puedas probar cuando cambien los datos de formatos nacionales.
Pruebas y límites de una implementación de checksum IBAN
Prueba el cálculo y el analizador con ejemplos identificados, entradas mal formadas y valores sintéticos. La normalización puede quitar espacios de impresión permitidos y convertir ASCII a mayúsculas; no debe eliminar cualquier puntuación, reemplazar caracteres parecidos ni inventar datos que falten.
- Usa valores sintéticos en pruebas y oculta los datos bancarios de clientes en los diagnósticos. MOD 97 detecta errores: no autentica ni aprueba pagos.
| Prueba | Comportamiento esperado | Capa |
|---|---|---|
| Ejemplo conocido coherente con el checksum | Resto 1 | Checksum |
| Un carácter modificado | Informar de un resto distinto de 1 | Checksum |
| Cero inicial en un campo numérico | Conservar el cero | Análisis y checksum |
| Longitud incorrecta o puntuación no admitida | Informar de error de formato o sintaxis | Validación de entrada |
Qué no demuestra un checksum IBAN MOD 97 válido
Un resto de 1 demuestra solo que los caracteres cumplen la relación matemática del checksum. No indica que un banco haya asignado el IBAN, que la cuenta siga abierta, que el destinatario sea su titular ni que pueda recibir un pago.
Un proceso de producción puede necesitar el registro nacional vigente, la confirmación del destinatario o un servicio autorizado de verificación. Mantén los estados separados, por ejemplo: formato aceptado, checksum correcto y datos bancarios sin verificar. Para transferir, utiliza el IBAN emitido por el banco; no cambies dígitos para forzar un resultado válido.
Preguntas frecuentes sobre el checksum IBAN MOD 97
¿MOD 97 equivale a comprobar la cuenta bancaria?
No. Comprueba la coherencia matemática de los caracteres del IBAN. No consulta un banco ni confirma asignación, estado, titularidad, identidad del destinatario o posibilidad de pago.
¿Qué resto debe producir un IBAN coherente con el checksum?
Tras rotar los cuatro primeros caracteres y expandir las letras, el resto final debe ser 1. La longitud y el patrón BBAN del país se comprueban por separado.
¿Cómo calculo los dígitos de control IBAN desde una BBAN?
Forma código de país + 00 + BBAN, rota los cuatro primeros caracteres, expande las letras y calcula el resto. Resta ese valor a 98, completa con dos dígitos, insértalos y valida el IBAN completo.
¿Debo aplicar este algoritmo a todos los formatos nacionales?
El paso de checksum internacional es común, pero la estructura BBAN y la longitud dependen del país. Consulta un registro vigente, como el Registro IBAN publicado por Swift, antes de validar el formato completo.
Lista de comprobación de implementación
Normaliza solo la entrada permitida, comprueba el formato nacional, rota, expande las letras y procesa MOD 97. Acepta el checksum únicamente cuando el resto final sea 1.
Para una comprobación práctica, abre el verificador de IBAN; para generar dígitos desde una BBAN, usa la calculadora de IBAN. Ninguna sustituye la verificación bancaria.
Referencias de estándares y formatos
- Registro IBAN de Swift y número internacional de cuenta bancaria — Swift publica el registro ISO 13616 de especificaciones nacionales de formato IBAN.
- Sistemas de caracteres de control ISO/IEC 7064:2003 — La página oficial describe sistemas de caracteres de control para detectar errores al copiar o teclear.