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.
| Livello | Domanda a cui risponde | Esempio di errore |
|---|---|---|
| Sintassi dell’input | Caratteri e spazi sono ammessi? | È presente una barra, un segno di punteggiatura o un simbolo non supportato. |
| Formato paese | Il paese usa questa lunghezza e questo schema BBAN? | Il codice paese è associato a una lunghezza totale errata. |
| Checksum MOD 97 | I caratteri rispettano la relazione delle cifre di controllo? | Un carattere modificato fa sì che il resto non sia più 1. |
| Verifica bancaria o del pagamento | Il 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.
- NormalizzaRimuovi gli spazi ammessi, converti in maiuscolo le lettere ASCII e rifiuta i caratteri non supportati.
- RuotaSposta alla fine i primi quattro caratteri dell’IBAN.
- Espandi le lettereSostituisci A–Z con 10–35 e lascia invariate le cifre decimali.
- 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 calcolo | Cifre elaborate | Resto |
|---|---|---|
| Dopo il primo blocco | 3214282912 | 23 |
| Aggiungi le 10 cifre successive | 3456987654 | 58 |
| Aggiungi le ultime 8 cifre | 32161182 | 1 |
| Risultato finale | 3214282912345698765432161182 mod 97 | Checksum 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.
- Parti dalla BBAN correttaOttieni i campi bancari secondo il formato nazionale registrato.
- Inserisci cifre provvisorieForma codice paese + 00 + BBAN, poi ruota ed espandi i caratteri.
- Calcola due cifreSottrai il resto da 98 e aggiungi uno zero iniziale se necessario.
- 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.
| Test | Comportamento atteso | Livello |
|---|---|---|
| Esempio noto coerente con il checksum | Resto 1 | Checksum |
| Un carattere modificato | Segnalare un resto diverso da 1 | Checksum |
| Zero iniziale in un campo numerico | Conservare lo zero | Parser e checksum |
| Lunghezza errata o punteggiatura non ammessa | Segnalare un errore di formato o sintassi | Validazione 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
- Registro IBAN Swift e numero internazionale di conto bancario — Swift pubblica il registro ISO 13616 delle specifiche nazionali dei formati IBAN.
- Sistemi di caratteri di controllo ISO/IEC 7064:2003 — La pagina ufficiale descrive sistemi di controllo che aiutano a rilevare errori di copia o digitazione.