Rezepte — IBAN validieren in Ihrem Stack

Erstellen Sie einen kostenlosen Schlüssel ohne E-Mail-Adresse. Er bietet normalerweise 25 Anfragen pro Monat; lesen Sie monthly_limit in der Antwort. Ein Code an eine freiwillig angegebene Adresse erhöht denselben Schlüssel auf 200 pro Monat. Speichern Sie api_key in Ihrer Geheimnisverwaltung; erstellen Sie nicht für jeden Aufruf einen neuen Schlüssel.

curl -X POST https://api.ibanforge.com/v1/keys/generate

Die Rezepte senden eine IBAN an die API, um das Format und verfügbare Bankdaten zu prüfen. Eine fehlende Bank oder unknown bestätigt kein Konto. Die Prüfung belegt weder die Existenz noch den Inhaber des Kontos. Anleitung für den ersten Aufruf.

Python

IBANFORGE_API_KEY = api_key aus dem vorherigen Schritt, in einer serverseitigen Umgebungsvariablen.

Mit dem offiziellen SDK (pip install ibanforge):

import os
from ibanforge import IBANforge
 
with IBANforge(api_key=os.environ["IBANFORGE_API_KEY"]) as client:
    result = client.validate_iban("DE89370400440532013000")
    print(result["valid"])
    print(result.get("bank_code_check"))
    print(result.get("bic"))

Oder schlicht requests:

import requests
 
r = requests.post(
    "https://api.ibanforge.com/v1/iban/validate",
    json={"iban": "DE89370400440532013000"},
    headers={"Authorization": "Bearer ifk_ihr_schluessel"},
    timeout=15,
)
data = r.json()
print(data["valid"], data["bank_code_check"]["status"])  # True verified

Node.js / TypeScript

Natives fetch, keine Abhängigkeit:

const res = await fetch("https://api.ibanforge.com/v1/iban/validate", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer ifk_ihr_schluessel",
  },
  body: JSON.stringify({ iban: "DE89370400440532013000" }),
});
const data = await res.json();
console.log(data.valid, data.bic?.code, data.bank_code_check?.status);
// true COBADEFFXXX verified

Das offizielle SDK (npm install @ibanforge/sdk) kapselt denselben Aufruf mit Typen.

PHP

Nichts über das hinaus, was PHP mitbringt:

<?php
$payload = json_encode(["iban" => "DE89370400440532013000"]);
$ctx = stream_context_create(["http" => [
    "method"  => "POST",
    "header"  => "Content-Type: application/json\r\nAuthorization: Bearer ifk_ihr_schluessel",
    "content" => $payload,
    "timeout" => 15,
]]);
$data = json_decode(file_get_contents(
    "https://api.ibanforge.com/v1/iban/validate", false, $ctx), true);
echo $data["valid"] ? "gültig" : "ungültig", " — ",
     $data["bank_code_check"]["status"] ?? "n/a", PHP_EOL;
// gültig — verified

Java

Das offizielle Java-SDK (Java 17 oder neuer, nur Jackson) spiegelt den TypeScript-Client Methode für Methode. Es liegt auf Maven Central: com.ibanforge:ibanforge-sdk:1.5.0 einbinden.

IBANforge client = IBANforge.builder().apiKey(System.getenv("IBANFORGE_API_KEY")).build();
IBANValidationResult r = client.validateIban("DE89 3704 0044 0532 0130 00");
System.out.println(r.valid() + " " + r.bic().code() + " " + r.bankCodeCheck().status());

Fehler sind unter IBANforgeException typisiert: PaymentRequiredException (402, die x402-Challenge in accepts), RateLimitException, InvalidInputException, ApiException. client.formatIban(...) und die anderen kostenlosen Routen brauchen keinen Schlüssel. README und vollständige Methodentabelle.

C# / .NET

Das offizielle .NET-SDK (net8.0, keine Abhängigkeit ausserhalb des Frameworks) bietet dieselben Methoden als asynchrone Aufrufe. Installieren Sie IBANforge.Sdk 1.5.0 von NuGet:

dotnet add package IBANforge.Sdk --version 1.5.0

using var client = new IBANforgeClient(new IBANforgeOptions { ApiKey = Environment.GetEnvironmentVariable("IBANFORGE_API_KEY") });
var r = await client.ValidateIbanAsync("DE89 3704 0044 0532 0130 00");
Console.WriteLine($"{r.Valid} {r.Bic?.Code} {r.BankCodeCheck?.Status}");

Einen eigenen HttpClient (IHttpClientFactory) an den Konstruktor übergeben, wenn vorhanden; die Ausnahmen spiegeln die Java- und TypeScript-Hierarchie. README.

Google Sheets

Die offiziellen Funktionen speichern den Schlüssel in Ihren Nutzereigenschaften und senden Spalten in Batches. Kein Schlüssel gehört in eine Zelle.

1. Laden Sie die drei Apps-Script-Dateien herunter und entpacken Sie das ZIP. Öffnen Sie in einer Testtabelle Erweiterungen → Apps Script.
2. Ersetzen Sie Code.gs, fügen Sie eine HTML-Datei namens Sidebar hinzu und übernehmen Sie Sidebar.html. Blenden Sie appsscript.json in den Projekteinstellungen ein und ersetzen Sie den Inhalt durch das mitgelieferte Manifest. Speichern.
3. Führen Sie ibfShowSidebar im Editor aus und autorisieren Sie das Script. Zurück in der Tabelle speichern Sie Ihren Schlüssel in der Seitenleiste, niemals in einer Zelle.
4. Importieren Sie diese beiden Test-IBANs in Spalte A über Datei → Importieren. Es sind ein öffentliches Dokumentationsbeispiel und seine Variante mit falscher Prüfziffer, keine Zahlungskonten. In B2 geben Sie =IBAN_PRUEFUNG(A2:A3) ein und lassen fünf Spalten frei.
5. Prüfen Sie beide Zeilen: TRUE für das erste Format, FALSE für das zweite. Danach Bank, BIC, Bankcode-Ergebnis und SEPA lesen. Fehlende Felder sind keine Zahlungsfreigabe.

Zwei IBANs verbrauchen zwei Kontingenteinheiten. Der Cache kann erneute Anfragen bis zu sechs Stunden vermeiden; seine Aufbewahrung ist nicht garantiert. Manuelle Installation; dieser Download ist kein Eintrag im Google Workspace Marketplace. Alle Funktionen und Grenzen.

n8n

Erster Test auf n8n Cloud oder eigenem Server

1. Workflow-JSON herunterladen und Import from File im n8n-Workflow-Menü wählen. Es enthält nur zwei integrierte Nodes: Manual Trigger und HTTP Request. Keine Erweiterung und kein Schlüssel sind enthalten.
2. Contrôler l’exemple de documentation öffnen: POST an /v1/iban/validate, JSON mit dem öffentlichen Beispiel DE89370400440532013000. Einmal manuell ausführen.
3. In der Ausgabe valid, bank_code_check und verfügbare Quellen prüfen. Der Workflow führt weder Zahlungen noch Folgeaktionen aus. HTTP-Fehler, erschöpftes Kontingent und Zeitüberschreitungen stoppen den Schritt.
4. Für Ihr eigenes Schlüsselkontingent im HTTP-Node Generic Credential Type → Header Auth wählen: Name Authorization, Wert Bearer gefolgt von Ihrem Schlüssel. Den Schlüssel in den Zugangsdaten speichern, niemals im exportierten JSON.

Der Test ohne Schlüssel verwendet das REST-Kontingent aus der Startanleitung, gemeinsam pro Netzwerkadresse. n8n-Cloud-Nutzer können eine Adresse teilen; bei erschöpftem Kontingent Ihren Schlüssel konfigurieren. Workflow importieren · HTTP-Request-Optionen.

Community-Erweiterung für selbst gehostetes n8n

Das veröffentlichte Paket n8n-nodes-ibanforge@0.1.1 bietet IBAN-Validierung, BIC-Suche, Schweizer Clearing und Compliance-Vorprüfungen auf Bankebene. Dieses Rezept gilt für selbst gehostetes n8n, mit einem Owner- oder Admin-Konto. Die Installation eines Pakets aus npm ist auf n8n Cloud nicht verfügbar; dort ist ein verifizierter Eintrag erforderlich. Siehe die Installationsanleitung von n8n.

1. Settings → Community nodes → Install öffnen und n8n-nodes-ibanforge@0.1.1 eingeben.
2. Einen kostenlosen API-Schlüssel beziehen (25 Anfragen/Monat ohne E-Mail, 200 nach Beanspruchung, ohne Karte). In einem neuen Workflow Manual Trigger mit IBANforge verbinden und den Schlüssel in den Zugangsdaten IBANforge API hinterlegen.
3. Validate IBAN auswählen, das Dokumentationsbeispiel DE89370400440532013000 eingeben und den Schritt ausführen.
4. Die JSON-Ausgabe prüfen: valid sollte für dieses Beispiel true sein, bank_code_check beschreibt das Registerergebnis und bic die Bank, sofern sie ermittelt werden kann. Eine abgeschlossene Operation mit diesen Feldern belegt den ersten API-Aufruf; ein grüner Verbindungstest allein genügt nicht.

In Version 0.1.1 ruft der Verbindungstest den öffentlichen Endpunkt /v1/demo auf, der den Schlüssel nicht prüft. Vor dem Einsatz des Workflows das tatsächliche Ergebnis von Validate IBAN kontrollieren. Weder ein gültiges Format noch eine identifizierte Bank belegen, dass das Konto existiert oder einem bestimmten Zahlungsempfänger gehört.

Für eine manuelle Installation die folgenden Befehle als Benutzer des n8n-Dienstes ausführen, gegebenenfalls in dessen Container. Anschliessend n8n neu starten:

mkdir -p ~/.n8n/nodes
cd ~/.n8n/nodes
npm install n8n-nodes-ibanforge@0.1.1

Der Node verarbeitet jedes eingehende Element einzeln; er hat keine Batch-Operation. Eine Liste mit 100 Elementen kann daher 100 Anfragen verbrauchen. Details zur manuellen Installation.

Odoo

Das öffentliche Odoo-Modul, Version 18.0.1.0.0 (AGPL-3), füllt BIC und Bankname aus, wenn die API sie ermitteln kann. Es benötigt Odoo 18 mit Unterstützung für eigene Python-Module, auf Ihrem eigenen Server oder auf Odoo.sh. Odoo Online unterstützt diese Module nicht. Diese Installation verwendet das Quellcode-Repository und ist nicht von einem Eintrag im Odoo Apps Store abhängig.

Auf Ihrem eigenen Odoo-Server das Repository in ein Verzeichnis Ihrer Wahl klonen:

git clone --branch 18.0 --single-branch https://github.com/cammac-creator/ibanforge-odoo.git /path/to/ibanforge-odoo

/path/to/ibanforge-odoo zur bestehenden addons_path-Liste von Odoo hinzufügen und die anderen Einträge beibehalten. Das Modul liegt im Unterverzeichnis: Das Manifest muss unter /path/to/ibanforge-odoo/ibanforge_bank_autofill/manifest.py liegen. Alternativ nur dieses Verzeichnis ibanforge_bank_autofill in ein bereits konfiguriertes Addons-Verzeichnis kopieren. Die Python-Bibliothek requests muss in der Odoo-Umgebung verfügbar sein. Auf Odoo.sh dieses Modulverzeichnis nach der Anleitung für eigene Module zum Projekt hinzufügen.

1. Odoo neu starten, den Entwicklermodus aktivieren und die Apps-Liste aktualisieren. Bei Bedarf den Standardfilter Apps entfernen, dann IBANforge Bank Auto-fill (ibanforge_bank_autofill) installieren.
2. Einstellungen → IBANforge öffnen, Ihren API-Schlüssel einfügen und die Einstellungen speichern. Die voreingestellte API-Adresse beibehalten. Ohne Schlüssel sendet das Modul keine Netzwerkanfragen.
3. In einer Testdatenbank ein Partner-Bankkonto mit DE89370400440532013000 anlegen. Das Bankfeld leer lassen, die IBAN eingeben und das Feld verlassen. Die erkannte Bank und den BIC oder die verknüpfte Bank prüfen, speichern und das Konto erneut öffnen, um die gespeicherte Bankverknüpfung zu kontrollieren.

Wenn die API nicht erreichbar ist oder kein BIC gefunden wird, bleibt die automatische Ergänzung aus; das Speichern wird dadurch nicht blockiert. Odoos Modul base_iban prüft weiterhin das IBAN-Format. Beim Speichern bleibt eine bereits eingetragene Bank erhalten. Eingabe und Speichern eines neuen Kontos können zwei API-Aufrufe benötigen: 200 monatliche Anfragen entsprechen daher nicht 200 manuell erfassten Konten. Die IBAN wird an die konfigurierte API übermittelt; das Ergebnis belegt keine Kontoinhaberschaft. Verhalten und Grenzen des Moduls.

KI-Agenten (MCP)

Remote MCP: https://api.ibanforge.com/mcp in einem kompatiblen Client hinzufügen. Für einen lokalen Prozess:

npx -y ibanforge-mcp

Oder der gehostete Transport, ohne Installation: https://api.ibanforge.com/mcp — 10 kostenlose Tool-Aufrufe pro IP und Tag, ganz ohne Schlüssel: der schnellste Weg für einen Assistenten, die Daten zu prüfen, bevor Sie sich festlegen.

Was zurückkommt

Die Antwort, die die Rezepte ausgeben (Produktionsantwort, gekürzt):

{
  "valid": true,
  "bic": { "code": "COBADEFFXXX", "bank_name": "Commerzbank", "city": "Köln" },
  "bank_code_check": {
    "value": "37040044",
    "status": "verified",
    "register": "Deutsche Bundesbank Bankleitzahlendatei",
    "authoritative": true,
    "as_of": "2026-08"
  }
}

authoritative: true heißt: das Nationalregister selbst hat geantwortet. Felder, die die Daten nicht tragen, sind null — nie geraten. Die vollständige Semantik erklärt, was verified verspricht und was nicht.

Siehe auch: Was „verified" bedeutet · IBAN zu BIC · Test-IBAN-Generator · Datenquellen