IBAN-Validierung: Mehr als nur eine Prüfsumme

Die meisten IBAN-Validierungsbibliotheken führen lediglich eine Modulo-97-Prüfsumme durch. Das erkennt Tippfehler, sagt Ihnen aber nichts darüber aus, ob die Bank existiert, wie ihr BIC-Code lautet oder ob sie am SEPA-Verfahren teilnimmt. Die Veille IBAN-Validierungs-API (GET /v1/vat/iban) geht weiter und gibt vollständige Bankdetails zusammen mit der mathematischen Prüfung zurück.

Was die API zurückgibt

Für jede IBAN erhalten Sie: valid (Boolean), bank_name, bic (SWIFT-Code), country_code, country_name, die strukturelle Aufschlüsselung (bank_code, branch_code, account_number, bban) und in_sepa_zone.

Schnelle Integration

Python

import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://api.veille.io/v1"

response = requests.get(
    f"{BASE_URL}/vat/iban",
    params={"query": "FR7630006000011234567890189"},
    headers={"x-api-key": API_KEY},
)
data = response.json()

if data["valid"] and data["in_sepa_zone"]:
    print(f"SEPA-ready - {data['bank_name']} (BIC: {data['bic']})")
else:
    print("IBAN invalid or outside SEPA zone")

TypeScript

const API_KEY = "YOUR_API_KEY";
const BASE_URL = "https://api.veille.io/v1";
const headers = { "x-api-key": API_KEY };

const response = await fetch(
  `${BASE_URL}/vat/iban?query=FR7630006000011234567890189`,
  { headers }
);
const data = await response.json();

if (data.valid && data.in_sepa_zone) {
  console.log(`SEPA-ready - ${data.bank_name} (BIC: ${data.bic})`);
} else {
  console.log("IBAN invalid or outside SEPA zone");
}

Wichtige Antwortfelder

• valid - vollständige strukturelle Validierung und Prüfsummenprüfung
• bank_name - das Institut hinter der IBAN
• bic - BIC/SWIFT-Code für das Routing
• in_sepa_zone - ob die Bank SEPA-Überweisungen unterstützt
• bank_code / branch_code / account_number - BBAN-Aufschlüsselung

5 Anwendungsfälle

1. Zahlungsformular-Validierung - Die IBAN verifizieren und den Banknamen anzeigen, bevor der Nutzer absendet, um fehlgeschlagene Überweisungen zu reduzieren.
2. SEPA-Lastschrift - Die SEPA-Zonenmitgliedschaft vor der Einrichtung eines Mandats bestätigen, um abgelehnte Lastschriften zu vermeiden.
3. Lieferantenzahlungen - Den BIC automatisch aus der IBAN auflösen, um Überweisungsdetails vorauszufüllen.
4. KYC-Onboarding - Das Bankland mit dem vom Kunden angegebenen Wohnsitzland abgleichen.
5. Auszahlungssysteme - IBANs von Freiberuflern oder Creators vor der Planung von Auszahlungen validieren, um fehlgeschlagene Transaktionen zu verhindern.

Verwandte Artikel

• MwSt-Validierung für europäische SaaS-Unternehmen - EU-Mehrwertsteuernummern neben IBANs validieren für eine vollständige B2B-Überprüfung
• Aufbau einer Betrugserkennungs-Pipeline - Zahlungs-, E-Mail- und IP-Signale für umfassende Betrugsprävention kombinieren
• Die Veille API in einem autonomen Paperclip-Unternehmen nutzen - IBAN- und MwSt-Validierung in einem autonomen Paperclip-Abrechnungsagenten