Controlla il formato nazionale, la lunghezza e le cifre di controllo prima di salvare i dati di pagamento del cliente.
API di validazione IBAN SEPA
Valida gli IBAN e verifica la partecipazione della banca a SEPA
Verifica un IBAN e la partecipazione della banca ai bonifici SEPA, ai bonifici istantanei e agli addebiti diretti Core e B2B. Ottieni un risultato separato per ogni schema in una risposta JSON, utilizzando i dati bancari e i registri dei partecipanti dell’EPC.
Inizia con 10 richieste API gratuite ogni 24 ore.
L’IBAN è valido e la banca supporta il tuo schema SEPA?
Sono verifiche distinte. Un IBAN può superare i controlli di formato e cifre di controllo anche quando la partecipazione della banca a uno specifico schema di pagamento non è confermata. Verifica entrambi gli aspetti quando raccogli i dati di pagamento o prepari una distinta.
Utilizza gli elenchi bancari disponibili per identificare la banca e il BIC. Le verifiche tramite elenchi sono disponibili per 40 paesi.
Leggi il singolo risultato per il tuo bonifico, bonifico istantaneo o addebito diretto.
Quattro schemi SEPA, quattro risultati indipendenti
Bonifico SEPA
details.sepa.sct
Indica la partecipazione della banca allo schema di bonifico SEPA ordinario.
Bonifico SEPA istantaneo
details.sepa.sctInst
Indica la partecipazione allo schema di bonifico istantaneo. Non è una verifica della raggiungibilità in tempo reale tramite RT1/TIPS né una garanzia di esecuzione istantanea.
Addebito diretto Core
details.sepa.sddCore
Indica la partecipazione allo schema di addebito diretto SEPA Core.
Addebito diretto B2B
details.sepa.sddB2b
Indica la partecipazione allo schema tra imprese B2B. Non dedurre questo risultato da quello dello schema Core.
I dati provengono dai registri separati per ciascuno schema dell’European Payments Council. Un risultato confermato richiede un’identificazione univoca della banca e una corrispondenza con un partecipante attualmente aderente nei dati di registro aggiornati.
Richiesta all’API SEPA e risposta JSON
Utilizza l’endpoint di validazione IBAN con la tua chiave API. I risultati SEPA sono inclusi quando vengono restituiti dati bancari; non è necessaria un’ulteriore richiesta per verificare gli schemi.
curl --get "https://www.iban-test.eu/api/v2/iban/validate" \
--header "Authorization: Bearer YOUR_API_TOKEN" \
--data-urlencode "iban=DE89370400440532013000"Estratto di una risposta di esempio che mostra solo i campi SEPA. I risultati effettivi dipendono dall’IBAN e dai dati di registro disponibili.
{
"details": {
"sepa": {
"sct": {
"status": "confirmed",
"reason": "matched"
},
"sctInst": {
"status": "confirmed",
"reason": "matched"
},
"sddCore": {
"status": "confirmed",
"reason": "matched"
},
"sddB2b": {
"status": "confirmed",
"reason": "matched"
}
}
}
}Consulta il riferimento completo dei campi SEPA e dei motivi del risultato.
Gestisci correttamente i risultati confermati e sconosciuti
Gestisci prima gli IBAN non validi. La partecipazione a SEPA è un’informazione aggiuntiva e non modifica il risultato della validazione IBAN.
confirmed con motivo matched conferma la partecipazione della banca a quello schema. Ogni schema deve essere valutato separatamente.
unknown significa che non è stato possibile confermare la partecipazione. Controlla il motivo e prevedi una verifica o una procedura alternativa, anziché contrassegnare automaticamente la banca come non compatibile.
Ad esempio, missing_bic indica che il BIC della banca non era disponibile; no_match, che non è stato trovato un partecipante corrispondente; e stale_data, che i dati del registro non sono aggiornati.
Questa API valida gli IBAN e verifica la partecipazione bancaria. Non avvia pagamenti, non verifica la titolarità o l’esistenza dei conti, non conferma mandati di addebito diretto e non garantisce il regolamento. L’idoneità del conto e l’instradamento dei pagamenti in tempo reale devono essere gestiti dal tuo fornitore di servizi di pagamento.
Integra i controlli SEPA nel tuo flusso di pagamento
Utilizza questi risultati durante l’acquisizione dei clienti, l’attivazione degli addebiti diretti e la preparazione dei pagamenti. Inizia con una chiave API gratuita, esamina una risposta e gestisci lo schema richiesto nella tua applicazione.
Per i controlli generali di formato, cifre di controllo ed elenchi bancari, consulta l’API di validazione IBAN.