Guida tecnica agli IBAN

Calcolo checksum IBAN MOD 97: formula, esempio e codice

Un IBAN supera il controllo del checksum quando, dopo aver riordinato ed espanso i caratteri, il resto della divisione per 97 è 1. Il calcolo può procedere cifra per cifra senza creare un numero intero enorme.

Segui un esempio GB completo, scopri come generare le cifre di controllo da una BBAN nel formato nazionale e consulta implementazioni JavaScript e Python. Un checksum valido controlla la sequenza di caratteri, ma non conferma che una banca abbia aperto il conto.

Illustrazione editoriale di una sequenza IBAN trasformata in un flusso numerico per il controllo del resto MOD 97
Il checksum riordina ed espande i caratteri IBAN prima di controllare il resto.

Che cosa controlla il checksum MOD 97 dell’IBAN

Un IBAN combina un codice paese di due lettere, due cifre di controllo e una BBAN specifica del paese. MOD 97 verifica la relazione matematica tra i caratteri e le cifre di controllo. Non interroga una banca né una rete di pagamento.

Tieni distinti sintassi dell’input, lunghezza e schema BBAN registrati per il paese, e checksum. Swift pubblica il Registro IBAN ISO 13616 con i formati nazionali. ISO/IEC 7064 descrive sistemi di caratteri di controllo pensati per rilevare comuni errori di digitazione o copia.

LivelloDomanda a cui rispondeEsempio di errore
Sintassi dell’inputCaratteri e spazi sono ammessi?È presente una barra, un segno di punteggiatura o un simbolo non supportato.
Formato paeseIl paese usa questa lunghezza e questo schema BBAN?Il codice paese è associato a una lunghezza totale errata.
Checksum MOD 97I caratteri rispettano la relazione delle cifre di controllo?Un carattere modificato fa sì che il resto non sia più 1.
Verifica bancaria o del pagamentoIl conto esiste e può ricevere questo pagamento?Serve una banca o un servizio autorizzato, non MOD 97.

Checksum IBAN MOD 97: le quattro fasi del calcolo

Parti dalla forma elettronica dell’IBAN: rimuovi gli spazi di stampa ammessi e converti in maiuscolo le lettere ASCII, ma rifiuta gli altri simboli. Sposta alla fine i primi quattro caratteri. Sostituisci ogni lettera da A a Z con il suo valore decimale da 10 a 35; le cifre restano invariate.

Elabora le cifre espanse da sinistra a destra. Parti da zero e aggiorna resto = (resto × 10 + cifra) mod 97. Il valore intermedio rimane sempre tra 0 e 96, quindi non serve un numero intero molto grande. Un resto finale pari a 1 soddisfa la relazione del checksum.

Diagramma in quattro fasi: ruotare il prefisso IBAN, convertire le lettere in numeri, elaborare le cifre modulo 97 e confrontare il resto con uno
Il diagramma riassume la trasformazione; l’esempio svolto mostra la sequenza e l’aritmetica esatte.
  1. NormalizzaRimuovi gli spazi ammessi, converti in maiuscolo le lettere ASCII e rifiuta i caratteri non supportati.
  2. RuotaSposta alla fine i primi quattro caratteri dell’IBAN.
  3. Espandi le lettereSostituisci A–Z con 10–35 e lascia invariate le cifre decimali.
  4. Calcola modulo 97Aggiorna il resto per ogni cifra e accetta il checksum solo se il risultato finale è 1.

Esempio svolto: verifica GB82 WEST 1234 5698 7654 32

Questo valore è un esempio matematico, non una ricerca di conto. Dopo aver rimosso gli spazi e spostato i primi quattro caratteri, si ottiene WEST12345698765432GB82. Convertendo W=32, E=14, S=28, T=29, G=16 e B=11, la sequenza diventa 3214282912345698765432161182.

La tabella elabora la sequenza a blocchi. Ogni nuovo blocco viene aggiunto al resto precedente in base alla propria larghezza decimale, senza creare un unico numero enorme.

  • Conserva gli zeri iniziali di ogni blocco: i blocchi sono testo per il calcolo, non numeri di conto da normalizzare.
  • Il resto finale è 1. Questo non dimostra che il valore appartenga a un conto bancario attivo.
Punto del calcoloCifre elaborateResto
Dopo il primo blocco321428291223
Aggiungi le 10 cifre successive345698765458
Aggiungi le ultime 8 cifre321611821
Risultato finale3214282912345698765432161182 mod 97Checksum coerente

Generare le cifre di controllo IBAN da una BBAN

La validazione parte da un IBAN completo che contiene già due cifre di controllo. La generazione parte dal codice paese e da una BBAN nel corretto formato nazionale. Il checksum non indica quali dati bancari o quale conto usare.

Per calcolare le cifre, crea un valore temporaneo con codice paese, 00 e BBAN. Sposta alla fine i primi quattro caratteri, espandi le lettere e calcola il resto r modulo 97. Le cifre sono 98 − r, su due posizioni. Inseriscile dopo il codice paese e verifica l’IBAN completo: il resto deve essere 1. Per la BBAN GB WEST12345698765432, il valore temporaneo GB00... lascia resto 16. Quindi 98 − 16 = 82 e si ottiene GB82WEST12345698765432. Il calcolo produce cifre, non dati bancari verificati.

  1. Parti dalla BBAN correttaOttieni i campi bancari secondo il formato nazionale registrato.
  2. Inserisci cifre provvisorieForma codice paese + 00 + BBAN, poi ruota ed espandi i caratteri.
  3. Calcola due cifreSottrai il resto da 98 e aggiungi uno zero iniziale se necessario.
  4. Verifica il risultatoInserisci le cifre e conferma che l’IBAN completo lasci resto 1.

Implementazione JavaScript senza un intero enorme

Questa funzione controlla la sintassi di base e il checksum. In produzione verifica anche la lunghezza e lo schema BBAN correnti del paese.

function ibanMod97Remainder(input) {
  const iban = input.replace(/ /g, "").toUpperCase();
  if (!/^[A-Z]{2}[0-9]{2}[A-Z0-9]+$/.test(iban)) {
    throw new Error("Sintassi IBAN non valida");
  }

  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

Separa gli errori del checksum da quelli di sintassi o formato nazionale: il codice non verifica un conto bancario.

Calcolo progressivo in Python

Lo stesso ciclo con resto limitato funziona in Python. L’esempio mantiene l’IBAN come testo e demanda le regole nazionali di formato a un registro aggiornato.

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("Sintassi IBAN non valida")

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
  • L’esempio restituisce 1; il codice di produzione deve distinguere gli errori del parser da quelli del checksum.

Mantieni il calcolo del checksum testabile separatamente quando cambiano i dati dei formati nazionali.

Test e limiti di un’implementazione del checksum IBAN

Prova il calcolo e il parser con esempi etichettati, input non validi e valori sintetici. La normalizzazione può rimuovere gli spazi di stampa ammessi e convertire l’ASCII in maiuscolo; non deve eliminare punteggiatura arbitraria, sostituire caratteri simili o indovinare dati mancanti.

  • Usa valori sintetici nei test e oscura i dati bancari reali nella diagnostica. MOD 97 rileva errori, ma non autentica né approva pagamenti.
TestComportamento attesoLivello
Esempio noto coerente con il checksumResto 1Checksum
Un carattere modificatoSegnalare un resto diverso da 1Checksum
Zero iniziale in un campo numericoConservare lo zeroParser e checksum
Lunghezza errata o punteggiatura non ammessaSegnalare un errore di formato o sintassiValidazione input

Che cosa non dimostra un checksum IBAN MOD 97 valido

Un resto pari a 1 dimostra solo che i caratteri rispettano la relazione matematica del checksum. Non prova che una banca abbia assegnato l’IBAN, che il conto sia aperto, che il destinatario ne sia titolare o che possa ricevere pagamenti.

Un processo di produzione può richiedere un registro paese aggiornato, la conferma del destinatario o un servizio autorizzato di verifica. Mantieni separati gli stati, per esempio: formato accettato, checksum superato e dati bancari non verificati. Per un bonifico usa l’IBAN fornito dalla banca; non modificare cifre per forzare un esito valido.

Domande frequenti sul checksum IBAN MOD 97

MOD 97 equivale a verificare il conto bancario?

No. Controlla la coerenza matematica dei caratteri IBAN. Non contatta una banca e non conferma assegnazione, stato, titolarità, identità del destinatario o possibilità di pagamento.

Quale resto deve produrre un IBAN coerente con il checksum?

Dopo aver spostato i primi quattro caratteri ed espanso le lettere, il resto finale deve essere 1. Lunghezza e schema BBAN del paese si controllano separatamente.

Come calcolo le cifre di controllo IBAN da una BBAN?

Forma codice paese + 00 + BBAN, sposta i primi quattro caratteri, espandi le lettere e calcola il resto. Sottrailo da 98, completa a due cifre, inserisci i valori e verifica l’IBAN completo.

Devo applicare questo algoritmo a ogni formato paese?

Il passaggio internazionale del checksum è comune, ma lunghezza e struttura BBAN dipendono dal paese. Consulta un registro aggiornato, come il Registro IBAN pubblicato da Swift, prima di convalidare il formato completo.

Lista di controllo dell’implementazione

Normalizza solo input ammessi, verifica il formato paese, ruota ed espandi i caratteri, poi elabora MOD 97. Accetta il checksum solo se il resto finale è 1.

Per un controllo pratico, apri il verificatore IBAN; per generare cifre da una BBAN, usa il calcolatore IBAN. Nessuno dei due sostituisce la verifica bancaria.

Riferimenti a standard e formati