ForHosting KIT · Dati e file

Verificare formato, lunghezza e checksum di un IBAN

Un numero di conto bancario internazionale può sembrare plausibile anche se contiene un numero errato di caratteri o una cifra di controllo trascritta male.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

Questo validatore normalizza spazi e trattini comuni, identifica il codice paese, verifica la lunghezza ufficiale assegnata a quel paese e applica la regola del checksum mod-97 prevista da ISO 7064. Ogni decisione viene restituita separatamente, così Lei può controllare un conto oppure lasciare che il software decida se un record di pagamento è pronto per la fase successiva.

Parta da un IBAN completo e riconoscibile

Incolli o invii l’IBAN completo, includendo il codice paese di due lettere e le due cifre di controllo. Sono accettati gli spazi usati per raggruppare i caratteri e facilitarne la lettura, oltre ai trattini; il validatore li rimuove prima del controllo. Nel risultato normalizzato le lettere minuscole diventano maiuscole. Nessun altro segno di punteggiatura viene eliminato senza avviso, perché ciò potrebbe nascondere un errore di copia e incolla. Un valore strutturalmente utilizzabile deve iniziare con due lettere seguite da due cifre, mentre tutti i caratteri successivi devono essere lettere o numeri. La risposta include l’IBAN normalizzato, affinché un’integrazione possa archiviare o confrontare una rappresentazione coerente. Mostra inoltre il codice paese, la lunghezza effettiva e quella prevista, invece di fornire soltanto una risposta generica. Se il prefisso nazionale non compare nel registro IBAN supportato, la richiesta genera un errore di input. La distinzione è importante: uno schema sconosciuto non può essere valutato in modo affidabile e non va trattato come un semplice checksum non valido.

Comprenda i controlli di lunghezza e mod-97

Gli IBAN non condividono un unico numero universale di caratteri. Ogni paese partecipante stabilisce una lunghezza fissa, quindi un IBAN tedesco ha una dimensione prevista diversa da uno norvegese o maltese. Il validatore cerca la lunghezza associata al codice paese iniziale e la confronta con il valore normalizzato. Poi esegue la procedura definita per IBAN da ISO 7064: sposta in fondo i primi quattro caratteri, espande le lettere nei valori numerici da A uguale a 10 fino a Z uguale a 35 e valuta modulo 97 la sequenza decimale risultante. Un checksum valido lascia resto uno. L’implementazione calcola il resto progressivamente, cifra per cifra, anziché costruire un intero enorme che potrebbe superare l’intervallo numerico sicuro del linguaggio. La risposta indica separatamente `length_valid` e `checksum_valid`, quindi imposta `valid` solo quando entrambi i controlli hanno esito positivo. Una lunghezza errata impedisce la convalida del checksum, mantenendo la decisione prudente e semplice da interpretare nei flussi automatizzati.

Inserisca la verifica nel punto giusto del pagamento

Esegua questo controllo quando un IBAN entra nel Suo sistema: durante l’invio di un modulo, l’importazione di un CSV, l’inserimento di un beneficiario o la revisione finale prima di creare un’istruzione di pagamento. Un risultato negativo segnala un problema di formato, lunghezza o checksum e aiuta a individuare tempestivamente i comuni errori di trascrizione. Non dimostra che il conto bancario esista, sia aperto, appartenga al destinatario indicato o possa ricevere uno specifico bonifico. Tali verifiche richiedono servizi bancari o di un fornitore di pagamenti e possono comportare controlli di identità regolamentati. Mantenga circoscritto il ruolo del validatore: rifiuti gli identificativi palesemente malformati, mostri quali controlli non sono riusciti e chieda all’utente di confermare il numero tramite una fonte affidabile. L’algoritmo è deterministico e durante l’esecuzione non usa rete, valori casuali, orologio o consultazioni esterne, rendendo riproducibili le chiamate ripetute. Una richiesta API costa $0.002; la pagina può eseguire nel browser la stessa logica pura di validazione.

Validare il modulo di un beneficiario

Rilevi una lunghezza nazionale o una cifra di controllo errata prima dell’invio del record.

Esaminare dati di pagamento importati

Normalizzi e verifichi i campi IBAN di un lotto conservando i motivi esatti di ogni rifiuto.

Controllare un numero di conto

Verifichi un IBAN copiato manualmente prima che entri nel flusso di approvazione dei pagamenti.

Quanto costa una validazione tramite API?

Ogni richiesta costa $0.002. Lo strumento nel browser può eseguire localmente lo stesso controllo deterministico.

Un risultato valido dimostra che il conto esiste?

No. Conferma soltanto la lunghezza nazionale registrata e il checksum, senza contattare una banca né verificare il titolare.

Sono ammessi spazi e trattini?

Sì. Vengono rimossi prima del controllo e le lettere minuscole sono normalizzate in maiuscole.

Perché un codice paese sconosciuto genera un errore?

Senza una definizione nazionale riconosciuta non è possibile stabilire con affidabilità la lunghezza obbligatoria dell’IBAN.

Come viene calcolato il checksum in sicurezza?

Il valore alfanumerico riordinato viene espanso e ridotto progressivamente modulo 97, evitando interi sovradimensionati.

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

POSThttps://api.kit.forhosting.com/data/iban-validate

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

curl -X POST https://api.kit.forhosting.com/data/iban-validate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"iban":"DE89 3704 0044 0532 0130 00"}'
{
  "iban": "DE89 3704 0044 0532 0130 00"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "data.iban_validate",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

max_mb25
HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →