Guida alla validazione IBAN

Validazione IBAN: come controllare un IBAN in sicurezza

La validazione IBAN è un controllo a livelli di una stringa fornita dalla banca: formato del paese, lunghezza prevista, caratteri ammessi e relazione delle cifre di controllo MOD-97. Una procedura chiara trova gli errori di copia senza confondere un formato coerente con un conto reale.

Questa guida mostra come validare un IBAN, leggere gli errori più comuni e capire quando serve la banca o il provider di pagamento. È utile a operations, assistenza, QA e sviluppatori che devono separare la sintassi dalla verifica del conto.

Illustrazione editoriale della validazione IBAN che separa formato nazionale, lunghezza e controllo MOD-97
La validazione IBAN verifica una stringa strutturata; non cerca pubblicamente un conto.

Che cosa significa la validazione IBAN

La validazione IBAN controlla se un numero di conto bancario internazionale è coerente con il formato registrato di un paese. In pratica verifica un prefisso plausibile, la lunghezza corretta, i caratteri consentiti e le cifre che rispettano la regola internazionale MOD-97. È utile perché un carattere mancante, una cifra scambiata o un prefisso sbagliato può far rifiutare un modulo prima che la banca elabori il pagamento.

La parola validazione può indicare livelli diversi, che vanno separati. Un controllo del formato non è una consultazione bancaria, una corrispondenza del nome del beneficiario, un controllo sanzioni o una garanzia di ricezione. Nel risultato indica esattamente che cosa è passato: “formato del paese e checksum superati” è più preciso di “questo è un conto valido”. Per l'azione immediata usa il verificatore IBAN; questa pagina spiega come interpretare il risultato e i suoi limiti.

La fonte deve essere il valore fornito dalla banca. Non costruire un IBAN personale da nome, carta, conto locale o esempio pubblico. Un generatore può produrre dati sintetici per lo sviluppo, ma non può scoprire un conto privato. Questo confine protegge i pagamenti reali e impedisce che le fixture di QA finiscano in produzione.

LivelloDomanda a cui rispondeChe cosa non dimostra
SintassiPrefisso e caratteri hanno l'aspetto di un IBAN?Che la stringa provenga da una banca.
Formato nazionaleIl paese usa questa lunghezza e questo BBAN?Che ogni campo nazionale sia attivo.
MOD-97Le cifre di controllo corrispondono al resto?Che esista un conto o appartenga al beneficiario.
Verifica autorizzataBanca o provider possono confermare il rapporto?Che ogni pagamento sia garantito in ogni condizione.

I livelli di validazione: paese, lunghezza, BBAN e MOD-97

Inizia dal codice paese. Le prime due lettere selezionano una specifica nazionale e le due cifre successive sono le cifre di controllo internazionali. Il resto è il Basic Bank Account Number, o BBAN. Un BBAN tedesco, francese, britannico o olandese può usare posizioni, caratteri e lunghezze diverse. Il verificatore deve quindi selezionare la regola del paese prima di giudicare il valore.

Confronta poi la lunghezza normalizzata con quella registrata. Rimuovi solo gli spazi di presentazione, conserva gli zeri iniziali e rifiuta punteggiatura o caratteri nascosti non previsti dal contratto di input. La lunghezza corretta è necessaria ma debole: molte stringhe errate hanno lo stesso numero di caratteri. Il pattern BBAN aggiunge il controllo di cifre, lettere, codici banca, filiale e chiavi nazionali nelle posizioni previste.

Infine esegui il calcolo MOD-97. Sposta i primi quattro caratteri in fondo, converti A-Z nei valori da 10 a 35 e calcola il resto progressivo. Un IBAN completo è normalmente coerente quando il resto finale è 1. Il checksum trova molti errori di trascrizione, ma resta una relazione matematica tra caratteri.

Diagramma editoriale dei quattro passi per validare un IBAN: normalizzare, controllare il paese, calcolare MOD-97 e confermare la fonte
Esegui i controlli strutturali in ordine e mantieni la conferma bancaria come risultato separato.
  1. Scegli la regola del paeseLeggi il prefisso di due lettere e carica lunghezza e pattern BBAN registrati.
  2. Normalizza la visualizzazioneRimuovi gli spazi, usa le maiuscole se consentito e rifiuta la punteggiatura inattesa.
  3. Controlla il checksumRuota la stringa, espandi le lettere e calcola il resto modulo 97.
  4. Segnala il limiteEtichetta il risultato come formato o checksum, salvo una verifica bancaria autorizzata.

Come validare un IBAN passo dopo passo

Per prima cosa ottieni il valore completo da un estratto, una sessione bancaria autenticata, l'app ufficiale o un'istruzione di pagamento verificata. Conserva la presentazione originale per poterla confrontare se il controllo fallisce. Se un messaggio modifica le coordinate di pagamento, confermalo tramite un secondo canale affidabile. Un controllo di formato non rileva ogni frode: anche un valore fraudolento può essere formalmente corretto.

Poi normalizza l'input secondo il contratto dello strumento o del provider. Gli spazi stampati sono di solito separatori e possono essere rimossi nel campo elettronico. Non completare caratteri mancanti, non sostituire una lettera con una cifra simile e non eliminare gli zeri iniziali. Rifiuta l'etichetta “IBAN”, barre, trattini o caratteri non ASCII se il parser non dichiara di accettarli.

Infine valida per livelli e conserva il primo errore utile. Se il paese non è supportato, non mostrare un errore di checksum come causa principale. Se la lunghezza è errata, chiedi di ricopiare il valore prima di analizzare MOD-97. Se il checksum fallisce dopo il formato, confronta ogni carattere e verifica che spazio o a capo non siano stati copiati come dati.

  1. 1. Conferma la fonteUsa una fonte bancaria attuale e controlla nome del conto e valuta.
  2. 2. Normalizza con attenzioneRimuovi solo gli spazi, conserva lettere e cifre e rifiuta simboli inattesi.
  3. 3. Applica le regole nazionaliConfronta paese, lunghezza, classi di caratteri e posizioni BBAN.
  4. 4. Esegui MOD-97Usa l'intera stringa e attesi un resto finale di 1 per la coerenza del checksum.
  5. 5. Inoltra correttamenteChiedi a banca o provider quando la decisione richiede più della sintassi.

Come leggere risultati positivi e negativi

Un buon validatore restituisce uno stato spiegato, non solo un badge verde. “Paese non supportato” indica che il registro non conosce il prefisso o che è stato copiato male; non autorizza a scegliere un altro paese. “Lunghezza errata” indica che il conteggio normalizzato non corrisponde alla specifica. “Caratteri non validi” spesso segnala punteggiatura, un'etichetta copiata, uno spazio non separabile o un carattere fuori alfabeto. Correggi la fonte invece di indovinare.

Un checksum fallito significa che la sequenza ruotata ed espansa non produce il resto previsto. Ricopia il valore, confronta i primi quattro caratteri e cerca una trasposizione. Un checksum superato significa solo coerenza matematica. Non prova che il conto sia aperto, che il nome coincida o che la banca destinataria accetti il pagamento. Questa limitazione deve essere visibile insieme allo stato positivo.

  • Non cambiare mai le cifre per ottenere un checksum positivo: elimineresti l'indizio dell'errore originale.
  • Tieni separati gli errori di formato nazionale e gli errori di checksum nelle analisi.
  • Mostra “formato accettato” invece di dichiarare che la banca ha confermato il conto.
RisultatoSignificato probabileAzione successiva
Paese non supportatoPrefisso assente dal registro o scritto male.Conferma prefisso bancario e copertura del registro.
Lunghezza errataIl numero di caratteri non segue la regola nazionale.Ricopia il valore; non aggiungere zeri.
Errore di patternCarattere o campo non segue il BBAN.Confronta fonte e istruzioni del paese.
Checksum fallitoMOD-97 fallisce dopo la normalizzazione.Controlla copia, spazi e rotazione.
Formato superatoLa stringa è coerente con le regole testate.Usa la verifica bancaria per le decisioni sul conto.

Che cosa la validazione IBAN non dimostra

Un validatore di formato può analizzare una stringa senza contattare una banca. Di solito rileva caratteri vietati, lunghezza errata, incompatibilità tra paese e BBAN e checksum MOD-97 fallito. È utile per moduli e pulizia dati, ma risponde a una domanda tecnica limitata. Una stringa può superare ogni regola locale ed essere comunque non assegnata, chiusa, inserita nel campo sbagliato o inadatta alla rotta di pagamento.

La validazione non stabilisce nemmeno chi possiede il conto. Non ricava l'IBAN di una persona da nome, carta, indirizzo o conto locale parziale. Non esegue verifica del beneficiario, sanzioni, saldo o autorizzazione. Queste decisioni spettano a una banca o a un provider autorizzato con accesso e controlli adeguati.

Per un bonifico reale, confronta l'IBAN completo con le istruzioni attuali della banca destinataria e conferma ogni modifica attraverso un canale sicuro. Per il software, usa valori sintetici identificati e protezioni d'ambiente. La guida ai dati IBAN di test spiega come tenere le fixture lontane da fatture, liste beneficiari, addebiti e chiamate di produzione.

  • La validità del formato non prova l'esistenza del conto.
  • Il prefisso del paese non prova dove vive il titolare.
  • Un checksum positivo non prova titolarità o corrispondenza del beneficiario.
  • Un controllo locale non è autorizzazione né garanzia di regolamento.

Checklist per sviluppo e QA della validazione IBAN

Implementa la validazione in fasi esplicite, così ogni chiamante può scegliere il messaggio corretto. Conserva il valore come testo, normalizza solo i caratteri di visualizzazione consentiti e carica le regole da un registro aggiornato. Non convertire un IBAN completo in un numero JavaScript o in un float: stringhe lunghe e zeri iniziali possono corrompersi. Un ciclo di resto modulo mantiene l'aritmetica limitata e facilita i test.

Una matrice utile include un valore sintetico noto per più paesi, varianti con spazi, minuscole, un carattere cambiato, due caratteri invertiti, un prefisso non supportato, una stringa troppo corta, una troppo lunga, punteggiatura e un caso limite delle cifre. La discussione per sviluppatori della ricerca mostra perché occorre controllare l'intervallo delle due cifre per non accettare l'ambiguità `00`/`97`. Verifica questo limite con il registro nazionale attuale.

Separa stati come `syntax_error`, `country_unsupported`, `length_error`, `pattern_error`, `checksum_error` e `format_pass`. Nei log evita IBAN completi dei clienti quando basta un valore hash o mascherato. Per una conferma reale inoltra alla banca o al provider, invece di inserire una chiamata di rete nascosta in un semplice controllo locale.

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'};
}

// Controlla anche lunghezza e BBAN prima di accettare il risultato.

Il codice mostra solo il limite aritmetico. Un servizio completo richiede regole nazionali aggiornate, errori chiari, controlli di privacy e una fase separata di verifica bancaria.

Scegli il passo successivo dopo la validazione

Se il valore fallisce, chiedi una nuova copia al titolare o alla banca. Non usare un esempio pubblico come modello di correzione e non modificare caratteri finché uno strumento non diventa verde. Per la QA, salva una fixture sintetica con etichetta d'ambiente. Per un pagamento reale, segui le istruzioni della banca destinataria e il controllo autorizzato del provider.

Il sito separa questi utilizzi. Usa il verificatore IBAN per formato e checksum, il decoder IBAN per vedere i campi e la guida MOD-97 per la formula. Se ti serve un valore bancario, leggi come trovare il tuo IBAN invece di generarlo.

  1. Formato superato per la documentazioneRegistra regola del paese, versione del registro e normalizzazione applicata.
  2. Fixture QASegna il valore come sintetico e tienilo fuori dai dati cliente e pagamento.
  3. Pagamento realeConferma i dati bancari e usa il percorso autorizzato del provider.

Domande frequenti sulla validazione IBAN

Che cosa controlla la validazione IBAN?

Può controllare sintassi, paese, lunghezza, caratteri BBAN e relazione MOD-97. I livelli dipendono dal registro e dal provider.

Un IBAN valido significa che il conto esiste?

No. Formato e checksum sono prove matematiche. Non dimostrano assegnazione, stato, titolarità, beneficiario o raggiungibilità del pagamento.

Come valido un IBAN prima di pagare?

Parti dal valore della banca, confronta conto e pagamento, esegui formato e checksum e usa banca o provider quando serve una conferma del conto.

Posso validare un IBAN con nome o carta?

No. Non ricavare dati bancari privati da nome, carta o conto parziale. Chiedi il valore alla banca o usa un canale autenticato.

Che cosa faccio se il checksum fallisce?

Ricopia il valore, rimuovi solo gli spazi, confronta i primi quattro e gli ultimi caratteri e chiedi un nuovo valore. Non modificare le cifre.

Un verificatore IBAN equivale a una verifica bancaria?

No. Il verificatore testa stringa e formato; un servizio autorizzato conferma il rapporto con il conto secondo le proprie regole.

Checklist per una validazione IBAN sicura

Valida a livelli: usa una fonte affidabile, normalizza gli spazi, scegli la regola del paese, controlla lunghezza e BBAN e poi esegui MOD-97. Indica lo stato esatto e mantieni gli errori correggibili.

Un risultato positivo significa che la stringa è coerente secondo le regole testate. Non dimostra che esista un conto, chi lo possieda o che il pagamento venga regolato. Per queste decisioni servono banca o provider autorizzato.

Riferimenti di formato e implementazione