Prüfen Sie Länderformat, Länge und Prüfziffern, bevor Sie die Zahlungsdaten eines Kunden speichern.
SEPA IBAN Validierung API
IBANs validieren und die SEPA-Teilnahme der Bank prüfen
Prüfen Sie eine IBAN und die Teilnahme der Bank an SEPA-Überweisungen, Echtzeitüberweisungen, Basislastschriften und Firmenlastschriften. Sie erhalten für jedes Verfahren ein eigenes Ergebnis in einer JSON-Antwort – auf Grundlage von Bankdaten und den EPC-Teilnehmerregistern.
Starten Sie mit 10 kostenlosen API-Abfragen pro 24 Stunden.
Ist die IBAN gültig und unterstützt die Bank Ihr SEPA-Verfahren?
Das sind getrennte Prüfungen. Eine IBAN kann die Format- und Prüfziffernprüfung bestehen, während die Teilnahme der Bank an einem bestimmten Zahlungsverfahren unbestätigt bleibt. Prüfen Sie beides bei der Erfassung von Zahlungsdaten oder vor einem Zahlungslauf.
Ermitteln Sie Bank und BIC anhand verfügbarer Bankverzeichnisse. Verzeichnisprüfungen sind für 40 Länder verfügbar.
Lesen Sie das einzelne Ergebnis für Ihre Überweisung, Echtzeitüberweisung oder Lastschrift aus.
Vier SEPA-Verfahren, vier unabhängige Ergebnisse
SEPA-Überweisung
details.sepa.sct
Zeigt die Teilnahme der Bank am regulären SEPA-Überweisungsverfahren.
SEPA-Echtzeitüberweisung
details.sepa.sctInst
Zeigt die Teilnahme am Echtzeitüberweisungsverfahren. Dies ist weder eine Live-Erreichbarkeitsprüfung über RT1/TIPS noch eine Garantie für die Ausführung in Echtzeit.
SEPA-Basislastschrift
details.sepa.sddCore
Zeigt die Teilnahme am SEPA-Basislastschriftverfahren Core.
SEPA-Firmenlastschrift
details.sepa.sddB2b
Zeigt die Teilnahme am Firmenlastschriftverfahren B2B. Leiten Sie dieses Ergebnis nicht aus dem Core-Ergebnis ab.
Die Teilnehmerdaten stammen aus den separaten Verfahrensregistern des European Payments Council. Ein bestätigtes Ergebnis setzt eine eindeutige Bankzuordnung und einen aktuell gültigen Teilnehmertreffer in hinreichend aktuellen Registerdaten voraus.
SEPA-API-Anfrage und JSON-Antwort
Verwenden Sie den Endpunkt zur IBAN-Validierung mit Ihrem API-Schlüssel. Die SEPA-Ergebnisse sind enthalten, wenn Bankdaten zurückgegeben werden. Eine zusätzliche Anfrage zur Verfahrensprüfung ist nicht erforderlich.
curl --get "https://www.iban-test.eu/api/v2/iban/validate" \
--header "Authorization: Bearer YOUR_API_TOKEN" \
--data-urlencode "iban=DE89370400440532013000"
Beispielauszug einer Antwort mit ausschließlich den SEPA-Feldern. Die tatsächlichen Ergebnisse hängen von der IBAN und den verfügbaren Registerdaten ab.
{
"details": {
"sepa": {
"sct": {
"status": "confirmed",
"reason": "matched"
},
"sctInst": {
"status": "confirmed",
"reason": "matched"
},
"sddCore": {
"status": "confirmed",
"reason": "matched"
},
"sddB2b": {
"status": "confirmed",
"reason": "matched"
}
}
}
}
Bestätigte und unbekannte Ergebnisse richtig behandeln
Behandeln Sie zuerst ungültige IBAN-Eingaben. Die SEPA-Teilnahme ist eine zusätzliche Information und verändert das Ergebnis der IBAN-Validierung nicht.
confirmed mit dem Grund matched bestätigt die Bankteilnahme an diesem Verfahren. Jedes Verfahren muss einzeln ausgewertet werden.
unknown bedeutet, dass die Teilnahme nicht bestätigt werden konnte. Prüfen Sie den Grund und nutzen Sie eine zusätzliche Prüfung oder einen Ersatzablauf, statt die Bank automatisch als nicht unterstützt einzustufen.
Zum Beispiel bedeutet missing_bic, dass die BIC der Bank nicht verfügbar war. no_match bedeutet, dass kein passender Teilnehmer gefunden wurde, und stale_data, dass die Registerdaten veraltet sind.
Diese API prüft IBANs und die Bankteilnahme. Sie löst keine Zahlungen aus, bestätigt weder Kontoinhaberschaft noch Kontoexistenz oder ein Lastschriftmandat und garantiert keine erfolgreiche Zahlung. Die Eignung des konkreten Kontos und das aktuelle Zahlungsrouting muss Ihr Zahlungsdienstleister prüfen.
SEPA-Prüfungen in Ihren Zahlungsablauf integrieren
Nutzen Sie die Ergebnisse bei der Kundenanlage, der Einrichtung von Lastschriften und der Zahlungsvorbereitung. Starten Sie mit einem kostenlosen API-Schlüssel, sehen Sie sich eine Antwort an und werten Sie das benötigte Verfahren in Ihrer Anwendung aus.
Informationen zur allgemeinen Format-, Prüfziffern- und Bankverzeichnisprüfung finden Sie bei der IBAN-Validierungs-API.
