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.

Il modulo invia l’IBAN al backend per la validazione
Il backend protegge il token API e valuta la risposta

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.

Distingui IBAN validi, input non validi ed errori del servizio

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

Tutte le guide di integrazione · Documentazione API

Piani API

Scegli un piano API per il traffico dei tuoi moduli

Confronta i pacchetti API e scegli la quota adatta al tuo processo.

I volumi mensili sono calcolati su 30 giorni. Si applica il limite per ogni periodo di 24 ore.

* Offerte riservate all’uso commerciale, prezzi IVA esclusa.

Prima dell’integrazione

Domande su questo caso d’uso

Posso chiamare l’API direttamente da JavaScript nel browser?

Conserva il token Bearer sul server. Il modulo deve chiamare il tuo backend, che interroga IBAN-Test e restituisce le informazioni necessarie all’interfaccia.

Leggi la documentazione di autenticazione e integrazione

Un IBAN valido significa che il conto esiste?

No. La validità formale e le corrispondenze bancarie disponibili non confermano esistenza, intestatario o attività del conto, né l’idoneità ai pagamenti.

Cosa conferma la validazione IBAN

Cosa faccio se raggiungo il limite di richieste?

Gestisci la risposta relativa alla quota come una condizione del servizio. Non indicare l’IBAN del cliente come non valido. Sospendi i controlli fino al rinnovo della quota o scegli un pacchetto API adeguato.

Confronta piani API e quote di richieste

Esiste un esempio di integrazione funzionante?

Sì. I pacchetti includono PHP, Python/CSV, Excel/Power Query, Google Sheets/Apps Script e n8n, oltre a un esempio sulla partecipazione SEPA. Scegli quello adatto alla tua applicazione e segui le istruzioni di configurazione.

Scopri tutti i pacchetti e gli esempi di integrazione

La tua prossima integrazione

Aggiungi un controllo bancario al prossimo invio del modulo

Scegli la quota di richieste, crea l’accesso e collega l’endpoint di validazione al backend.

Scegli il piano API