Checkout, Registrierung und Kundenanlage

Prüfen Sie IBANs, bevor Ihr Formular sie speichert

Geben Sie Kunden die Möglichkeit, fehlerhafte Bankdaten noch im Formular zu korrigieren. Ergänzen Sie Checkout, Registrierung oder Kundenanlage um eine serverseitige IBAN-Prüfung mit der IBAN-Test API.

40 Länder

Bankverzeichnis-Prüfungen bei verfügbaren Quelldaten

115 IBAN-Formate

Länderregeln, Länge und Prüfziffern

REST API

Authentifizierte Anfragen und JSON-Antworten

Warum diese Prüfung wichtig ist

Hilfreiche Rückmeldungen direkt bei der Eingabe

Fehlerhafte Eingaben erkennen

Prüfen Sie Länderformat, erwartete Länge und Prüfziffern, bevor Sie die übermittelte IBAN übernehmen.

Mehr als die Prüfsumme prüfen

Nutzen Sie verfügbare Bankverzeichnisse, um das Institut zu identifizieren und Formatgültigkeit und Bankzuordnung zu unterscheiden.

API-Token auf dem Server halten

Rufen Sie IBAN-Test aus Ihrem Backend auf und geben Sie nur das benötigte Ergebnis an Ihr Formular zurück. Der Bearer-Token bleibt auf dem Server.

Von der Eingabe zum nutzbaren Ergebnis

So passt die Prüfung in Ihren Prozess

Schritt 1: IBAN im Formular erfassen

Nehmen Sie die Kundeneingabe entgegen und übermitteln Sie sie an Ihr eigenes Backend. Der Validierungsendpunkt unterstützt auch formatierte IBANs mit Leerzeichen.

Ein Kundenformular sendet die IBAN zur Prüfung an Ihr Backend
Ihr Backend hält den API-Token geheim und wertet die Prüfantwort aus

Schritt 2: Prüfung aus dem Backend ausführen

Senden Sie eine Anfrage mit Ihrem API-Token. Werten Sie HTTP-Antwort und JSON-Code aus; HTTP 200 und error:false allein bestätigen keine gültigen Bankdaten.

Schritt 3: Verständliche Rückmeldung anzeigen

Bitten Sie Kunden, ungültige Eingaben zu korrigieren. Behandeln Sie Authentifizierungs-, Kontingent- und vorübergehende Dienstfehler getrennt von einer ungültigen IBAN.

Rückmeldungen für gültige IBANs, ungültige Eingaben und Dienstfehler unterscheiden

Die API im praktischen Einsatz

Eine serverseitige Prüfung für Ihre Anwendung

Nutzen Sie die API mit Ihrem vorhandenen Backend. Unsere Integrationspakete bieten herunterladbare Beispiele für verschiedene Programmiersprachen und Werkzeuge, einschließlich serverseitiger Token-Verwaltung und getrennter Behandlung von Prüf- und Anfragefehlern.

Authentifizierte Prüfanfrage

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"}'

Veröffentlichte Referenz-IBAN für Integrationsbeispiele.

Auszug aus der Prüfantwort

{
  "error": false,
  "code": 2100,
  "message": "IBAN is valid"
}

Beispielauszug. Werten Sie die vollständige Antwort und den HTTP-Status aus.

Eingabefehler und Dienstfehler unterscheiden

Bei einer einzelnen IBAN-Prüfung kennzeichnet Antwortcode 2100 eine gültige IBAN. Codes wie 3100 stehen für ungültige Eingaben. Ein Authentifizierungs- oder Kontingentproblem erfordert eine Dienstmeldung und keine Meldung über ein ungültiges Kundenkonto.

Integrationspakete: PHP · Python / CSV · Excel / Power Query · Google Sheets / Apps Script · n8n · SEPA-Teilnahme

Alle Integrationsanleitungen · API-Dokumentation

API-Tarife

Wählen Sie einen API-Tarif für Ihre Formularaufrufe

Vergleichen Sie die aktuellen API-Pakete und wählen Sie das passende Anfragekontingent.

Monatswerte sind auf 30 Tage hochgerechnet. Es gilt das Limit pro 24 Stunden.

* Angebote nur für den gewerblichen Bedarf, Preise zzgl. MwSt.

Vor der Integration

Fragen zu diesem Anwendungsfall

Kann ich die API direkt aus JavaScript im Browser aufrufen?

Halten Sie den Bearer-Token auf Ihrem Server. Ihr Formular ruft Ihr Backend auf; dieses sendet die Anfrage an IBAN-Test und liefert die von der Benutzeroberfläche benötigten Informationen zurück.

Dokumentation zu Authentifizierung und Integration lesen

Bedeutet eine gültige IBAN, dass das Konto existiert?

Nein. Formale Gültigkeit und verfügbare Bankverzeichnis-Treffer bestätigen weder Kontoexistenz noch Kontoinhaber, Kontoaktivität oder Eignung des Kontos für Zahlungen.

Was die IBAN-Prüfung bestätigt

Was mache ich, wenn das Anfragelimit erreicht ist?

Behandeln Sie die Kontingentantwort als Dienstproblem. Kennzeichnen Sie die Kunden-IBAN nicht als ungültig. Pausieren Sie weitere Prüfungen, bis wieder Kontingent verfügbar ist, oder wählen Sie ein API-Paket mit passender Kapazität.

API-Tarife und Anfragekontingente vergleichen

Gibt es ein funktionsfähiges Integrationsbeispiel?

Ja. Unsere Integrationspakete decken PHP, Python/CSV, Excel/Power Query, Google Sheets/Apps Script und n8n ab; hinzu kommt ein Beispiel zur SEPA-Teilnahme. Wählen Sie das Paket für Ihre Anwendung und folgen Sie der Einrichtungsanleitung.

Alle Integrationspakete und Beispiele ansehen

Ihre nächste Integration

Ergänzen Sie Ihre nächste Formularübermittlung um eine Bankdatenprüfung

Wählen Sie Ihr Anfragekontingent, richten Sie Ihren Zugang ein und verbinden Sie den Validierungsendpunkt mit Ihrem Backend.

API-Tarif wählen