Guía técnica de IBAN

Calcular los dígitos de control IBAN MOD 97: fórmula, ejemplo y código

Un IBAN es coherente con su checksum cuando, tras reorganizar y expandir sus caracteres, el resto al dividir entre 97 es 1. El cálculo puede procesarse por dígitos, sin crear un entero enorme.

Sigue un ejemplo GB completo, aprende a generar los dígitos desde una BBAN con formato nacional y revisa implementaciones en JavaScript y Python. Superar el checksum comprueba una cadena; no confirma que un banco haya emitido una cuenta.

Ilustración editorial de una secuencia IBAN que se transforma en un flujo numérico para comprobar el resto MOD 97
El checksum reorganiza y expande los caracteres del IBAN antes de comprobar el resto.

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.

CapaPregunta que respondeFallo 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.

Diagrama de cuatro pasos: rotar el prefijo del IBAN, convertir letras en números, procesar los dígitos módulo 97 y comparar el resto con uno
El diagrama resume la transformación; el ejemplo resuelto muestra la cadena y las operaciones exactas.
  1. NormalizarQuita los espacios permitidos, pasa las letras ASCII a mayúsculas y rechaza caracteres no admitidos.
  2. RotarMueve al final del IBAN sus cuatro primeros caracteres.
  3. Expandir letrasSustituye A–Z por 10–35 y conserva los dígitos decimales.
  4. 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álculoDígitos procesadosResto
Tras el primer bloque321428291223
Añadir los siguientes 10 dígitos345698765458
Añadir los últimos 8 dígitos321611821
Resultado final3214282912345698765432161182 mod 97Checksum 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.

  1. Usar la BBAN correctaObtén los campos bancarios según el formato nacional registrado.
  2. Insertar dígitos provisionalesForma código de país + 00 + BBAN; después rota y expande.
  3. Calcular dos dígitosResta el resto a 98 y completa con un cero inicial si hace falta.
  4. 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.
PruebaComportamiento esperadoCapa
Ejemplo conocido coherente con el checksumResto 1Checksum
Un carácter modificadoInformar de un resto distinto de 1Checksum
Cero inicial en un campo numéricoConservar el ceroAnálisis y checksum
Longitud incorrecta o puntuación no admitidaInformar de error de formato o sintaxisValidació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