Checkout, registrazione e creazione clienti
Valida gli IBAN prima che il modulo li salvi
Consenti ai clienti di correggere i dati bancari mentre sono ancora nel modulo. Aggiungi la validazione IBAN sul server a checkout, registrazione o creazione clienti con l’API IBAN-Test.
40 paesi
Controlli bancari dove sono disponibili dati
115 formati IBAN
Regole nazionali, lunghezza e cifre di controllo
REST API
Richieste autenticate e risposte JSON
Perché questo controllo è utile
Fornisci indicazioni utili durante l’inserimento
Individua gli input malformati
Verifica formato nazionale, lunghezza prevista e cifre di controllo prima di accettare l’IBAN inviato.
Vai oltre la somma di controllo
Usa gli archivi bancari disponibili per identificare l’istituto e distinguere la validità formale dalla corrispondenza bancaria.
Conserva il token API sul server
Richiama IBAN-Test dal backend e restituisci ciò che serve al modulo senza esporre il token Bearer nel browser.
Dall’input a un risultato utile
Come integrare il controllo nel tuo processo
Passaggio 1: Raccogli l’IBAN nel modulo
Ricevi l’input del cliente e invialo al tuo backend. L’endpoint di validazione supporta anche gli IBAN con spazi.


Passaggio 2: Esegui la validazione dal backend
Invia una richiesta con il token API. Valuta risposta HTTP e codice JSON: HTTP 200 ed error:false da soli non confermano dati bancari validi.
Passaggio 3: Mostra un risultato su cui agire
Chiedi al cliente di correggere gli input non validi. Gestisci separatamente gli errori di autenticazione, quota o servizio temporaneo rispetto a un IBAN non valido.

L’API nella pratica
Una validazione sul server pronta per la tua applicazione
Usa l’API con il backend che hai già. I nostri pacchetti scaricabili coprono vari linguaggi e strumenti, la gestione del token sul server e il trattamento separato degli errori di validazione e di richiesta.
Richiesta di validazione autenticata
curl -X POST "https://www.iban-test.eu/api/v2/iban/validate" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
--data '{"iban":"DE89370400440532013000"}'IBAN di riferimento pubblicato per gli esempi di integrazione.
Estratto della risposta di validazione
{
"error": false,
"code": 2100,
"message": "IBAN is valid"
}Estratto illustrativo. Valuta la risposta completa e lo stato HTTP.
Distingui gli errori di input dai problemi del servizio
In una validazione singola, il codice 2100 indica un IBAN valido. Codici come 3100 segnalano input non validi. Un problema di autenticazione o quota richiede un messaggio di servizio, non l’affermazione che il conto del cliente sia errato.
Pacchetti di integrazione: PHP · Python / CSV · Excel / Power Query · Google Sheets / Apps Script · n8n · Partecipazione SEPA
