Zum Inhalt springen
Tutorial

Validieren Sie IBAN-Nummern mit einem API-Aufruf

| 5 min read

Validieren Sie jede IBAN, extrahieren Sie den Ländercode und die Prüfziffern und erhalten Sie eine formatierte Zeichenfolge zurück. Eine POST-Anfrage, über 80 Länder, kein Banking-SDK erforderlich.

International bank building facade
Photo by Sean Pollock on Unsplash

Ihr Zahlungsformular akzeptiert internationale Banküberweisungen. Der Benutzer gibt eine 22-stellige IBAN ein. Bevor Sie das an Ihren Zahlungsabwickler senden und auf einen Fehler warten, möchten Sie Tippfehler erkennen auf Formularebene. Die IBAN-Validierung umfasst einen länderspezifischen Modulo-97-Prüfzifferalgorithmus Längenregeln und BBAN-Strukturanalyse. Sie können es selbst schreiben, eine Bibliothek heranziehen oder lassen Eine API kümmert sich darum.

Botois /v1/validate/iban Der Endpunkt nimmt eine IBAN-Zeichenfolge und gibt zurück, ob dies der Fall ist gültig, die Landesvorwahl, den Ländernamen und eine formatierte Version der Nummer. Ein Beitrag Anfrage, kein Banking-SDK, keine zu pflegende Regex-Sammlung.

Der API-Aufruf

Antwort:

Als Antwort erhalten Sie vier Felder. valid ist der boolesche Wert, den Sie benötigen Gating auf Formularebene. country_code Und country ermöglicht Ihnen eine automatische Erkennung das Bankland des Benutzers für nachgelagerte Logik wie Währungsauswahl oder Steuerregeln. formatted gibt die IBAN in der Standardgruppierung mit vier Zeichen zurück erwarten Sie auf Rechnungen und Kontoauszügen.

Wenn die IBAN die Prüfziffernüberprüfung nicht besteht, erhalten Sie weiterhin die analysierten Felder:

Der valid: false Flagge ist alles, was Sie brauchen. Keine abzufangenden Ausnahmen, keine Fehlercodes nachschlagen. Überprüfen Sie den Booleschen Wert und zeigen Sie eine Fehlermeldung an.

Node.js

Python

IBAN-Formate nach Ländern

Die Länge der IBAN variiert je nach Land. Die ersten beiden Zeichen sind immer der ISO 3166-1-Ländercode, gefolgt von zwei Prüfziffern und dann der Basic Bank Account Number (BBAN). Hier sind die fünf meisten gängige Formate im europäischen Zahlungsverkehr:

Land Code Länge Format Beispiel
Deutschland VON 22 DE + 2 Prüfziffern + 8 BLZ + 10 Konto DE89 3704 0044 0532 0130 00
Vereinigtes Königreich GB 22 GB + 2 Prüfziffern + 4 Bankleitzahl + 6 Bankleitzahl + 8 Kontonummer GB29 NWBK 6016 1331 9268 19
Frankreich FR 27 FR + 2 Prüfziffern + 10 Bank + 11 Konto + 2 Schlüssel FR76 3000 6000 0112 3456 7890 189
Spanien ES 24 ES + 2 Prüfziffern + 4 Bank + 4 Filiale + 2 Kontrollziffern + 10 Konto ES91 2100 0418 4502 0005 1332
Niederlande NL 18 NL + 2 Prüfziffern + 4 Bank + 10 Konto NL91 ABNA 0417 1643 00

Die API verwaltet alle über 80 Länder im SWIFT-IBAN-Register. Sie müssen kein A pflegen Nachschlagetabelle mit Längen und Formaten; Der Endpunkt validiert anhand der korrekten Regeln für jeder Ländercode.

React/Preact-Formularvalidierung bei Unschärfe

Die häufigste Integration: Validieren Sie die IBAN, wenn der Benutzer das Eingabefeld verlässt. Durch den Aufruf von Blur (statt bei jedem Tastendruck) wird die API-Nutzung gering gehalten und ein Blinken vermieden Fehlermeldungen, während der Benutzer noch tippt.

Die Komponente ruft die API auf, wenn das Feld den Fokus verliert. Wenn die IBAN gültig ist, wird sie bestanden geparste Daten (Ländercode, formatierte Zeichenfolge) bis zum übergeordneten Formular über onValidated. Der Elternteil kann dann die Währung automatisch ausfüllen, die Weiterleitung anpassen oder die formatierte IBAN als anzeigen Bestätigung.

Batch-Validierung von IBANs aus einer CSV-Datei

Finanzteams müssen häufig eine Liste mit Lieferanten- oder Mitarbeiter-IBANs validieren, bevor sie eine erstellen Sammelzahlung. Dieses Skript liest eine CSV-Datei, validiert jede IBAN und markiert ungültige Einträge.

Das Skript wird mit Code 1 beendet, wenn eine IBAN ungültig ist, sodass sie als CI-Schritt oder verwendet werden kann Überprüfung vor dem Hochladen. Fügen Sie bei großen Dateien (mehr als 1.000 Zeilen) eine kleine Verzögerung zwischen den Anfragen hinzu oder Verwenden Sie einen API-Schlüssel, um höhere Ratenlimits zu erhalten.

Stripe Connect-Onboarding

Beim Onboarding von Verkäufern oder Freiberuflern über Stripe Connect erfassen Sie deren Bankdaten Auszahlungen einrichten. Überprüfen Sie die IBAN vor dem Anruf stripe.accounts.createExternalAccount vermeidet einen Roundtrip zur Stripe-API, der ohnehin fehlschlagen würde. Außerdem können Sie damit das extrahieren Geben Sie den Ländercode ein, um die korrekte Auszahlungswährung festzulegen.

Der Ablauf ist unkompliziert: Zuerst validieren, das Land extrahieren, es dann einer Währung zuordnen Erstellen Sie das externe Konto. Wenn die IBAN ungültig ist, wird dem Benutzer stattdessen sofort eine Fehlermeldung angezeigt zu warten, bis Stripe es Sekunden später ablehnt.

Wichtige Punkte

  • Ein POST, vier Felder. Senden Sie eine IBAN-Zeichenfolge an /v1/validate/iban und erhalten Sie Gültigkeit, Ländercode, Ländernamen und die formatierte Nummer zurück.
  • Über 80 Länder. Der Endpunkt deckt jedes Land im SWIFT-IBAN-Register ab. Keine länderspezifische Logik Ihrerseits.
  • Fehler auf Formularebene abfangen. Bestätigen Sie die Unschärfe in Ihrem Zahlungsformular Verhindern Sie, dass ungültige IBANs Ihre Bank oder Ihren Zahlungsabwickler erreichen.
  • Keine Speicherung, keine Protokollierung. Die IBAN wird im Speicher verarbeitet und verworfen. Nichts bleibt bestehen.
  • Kostenloses Kontingent verfügbar. Anonymer Zugriff mit 5 Anfragen pro Minute, 100 pro Tag. Für Entwicklung und Tests ist kein API-Schlüssel erforderlich.

FAQ

Verifiziert diese API, dass das Bankkonto existiert?
Nein. Es validiert die IBAN-Struktur und die Modulo-97-Prüfsumme. Es bestätigt, dass die Nummer korrekt formatiert ist, kontaktiert jedoch keine Bank und prüft nicht, ob das Konto offen oder gedeckt ist.
Wie viele Länder unterstützt die IBAN-Validierung?
Über 80 Länder haben den IBAN-Standard übernommen, darunter alle EU-/EWR-Mitgliedstaaten, das Vereinigte Königreich, die Schweiz, Saudi-Arabien und Brasilien. Die vollständige Liste folgt der SWIFT-IBAN-Registrierung.
Kann ich eine IBAN mit Leerzeichen senden?
Ja. Leerzeichen werden vor der Validierung automatisch entfernt. „DE89 3704 0044 0532 0130 00“ und „DE89370400440532013000“ liefern beide das gleiche Ergebnis.
Benötige ich einen API-Schlüssel, um IBANs zu validieren?
Nein. Der anonyme Zugriff erlaubt 5 Anfragen pro Minute mit IP-basierter Ratenbegrenzung und 100 Anfragen pro Tag. Für einen höheren Durchsatz melden Sie sich unter botoi.com/api für einen API-Schlüssel an.
Wird die IBAN, die ich übersende, gespeichert oder protokolliert?
Nein. Die IBAN wird im Speicher validiert und sofort verworfen. Es wird nichts gespeichert oder in ein Protokoll geschrieben.

Starte mit botoi zu entwickeln

150+ API-Endpunkte für Abfragen, Textverarbeitung, Bildgenerierung und Entwickler-Tools. Kostenloser Tarif, keine Kreditkarte nötig.