Entwickler und Integration

Das Mini-Widget von embed.js verknüpft jedes Eingabefeld über ein echtes label/for-Paar, setzt sichtbare Fokusstile und begrenzt die Eingabelänge über maxlength. Das Ergebnisfeld ist aktuell nicht als aria-live-Region ausgezeichnet.

Die IBAN-Validierung über embed.js verarbeitet die eingegebene IBAN ausschließlich lokal im Browser des Nutzers. Die serverseitige REST-API verarbeitet ausschließlich die übergebene Bankleitzahl, ohne zusätzliche Anfragedaten zu speichern.

Vor der eigentlichen Prüfung wandelt dieser Rechner eine eingegebene IBAN in Großbuchstaben um und entfernt alle Zeichen außer Buchstaben und Ziffern – unabhängig davon, ob der Nutzer Leerzeichen, Bindestriche oder Kleinbuchstaben verwendet hat.

Für die reine IBAN-Prüfung und -Berechnung genügt die clientseitige Funktions-API vollständig. Für einen Abgleich gegen die vollständige, laufend aktualisierte Bundesbank-Datenbank ist die serverseitige REST-API die passende Quelle.

Dieses Projekt bietet keine installierbare Paketbibliothek, sondern eine einzige, abhängigkeitsfreie JavaScript-Datei (embed.js) mit drei direkt aufrufbaren Funktionen: validate, buildIban und lookupBic – ohne Build-Schritt, ohne Paketmanager.

Die IBAN-Validierung dieses Rechners prüft in fester Reihenfolge Länge, Format und Modulo-97-Prüfsumme – vollständig lokal im Browser, ohne Netzwerkaufruf. IbanRechner.validate(iban) liefert ein strukturiertes Ergebnisobjekt mit Gründen bei Ungültigkeit.

Das fertige Mini-Widget lässt sich per <div data-iban-rechner data-mode="…"></div> plus embed.js einbinden – ohne eigenes UI zu bauen. Alternativ steht ein iframe-Widget (widget.html) für Umgebungen ohne eigenes JavaScript zur Verfügung.

Die Modulo-97-Prüfziffernprüfung bestätigt ausschließlich, dass die IBAN in sich rechnerisch konsistent ist. Eine tatsächliche Kontoverifikation – ob das Konto existiert und wem es gehört – ist damit weder verbunden noch von diesem Rechner leistbar.

Die serverseitige REST-API bietet vier read-only JSON-Endpunkte: GET /api/bank/:blz, /api/faq, /api/glossary und /api/status. Aktuell ohne API-Key, ohne Rate-Limit, ohne Versionierung und ohne CORS-Header.

Für Tests und Beispiele eignet sich eine formal gültige, in der Dokumentation dieses Projekts durchgängig verwendete Beispiel-IBAN. Reale, personenbezogene IBANs gehören nicht in Testumgebungen, Bugreports oder öffentlichen Code.

Dieser Rechner liefert bei einer ungültigen IBAN genau einen konkreten, auf den fehlgeschlagenen Prüfschritt bezogenen Fehlergrund – etwa zur Länge oder zur Prüfsumme – statt einer allgemeinen „ungültig“-Meldung.

Ein regulärer Ausdruck kann die formale Struktur einer IBAN prüfen, aber weder deren Länderlänge noch die Modulo-97-Prüfsumme berechnen. Eine reine Regex-Prüfung lässt formal plausible, aber rechnerisch ungültige IBANs unentdeckt durch.