DE ♦ EN

IBAN-BIC.com (Theano GmbH)  » Webservice  » Ohne SOAP  » REST-Interface-Dokumentation: validate_iban

Passwort vergessen?

Kontakt,
Impressum

Neuer Kunde? Neu anmelden

BBANs (nationale Kontonummern) in IBANs umwandeln: https://rest.sepatools.eu/calculate_iban

URL: rest.sepatools.eu/calculate_iban/{country}/{bankcode}/{account}[/{bic}[/{legacy_mode}]]

Beispiel:
https://rest.sepatools.eu/calculate_iban/IE/900017/10027952

Zweck:

  • Wandelt eine gegebene Kombination aus Ländercode, Bankcode und Kontonummer in eine IBAN um.
  • Fügt Informationen wie BIC-Code, Name der Bank, Adresse der Bank, URL.

Aufrufmechanismus kostenlos testen: um erst einmal ohne Kosten den Aufruf unserer Schnittstelle zu testen, empfehlen wir den Endpunkt rest.sepatools.eu/calculate_iban_dummy/IE/900017/10027952, der dieselben Parameter erwartet wie der Endpunkt rest_calculate_iban, auf denselben Servern läuft, denselben Authentifizierungsmechanismus nutzt und dieselbe Datenstruktur zurückliefert.

Dieser Dummy-Endpunkt liefert immer dasselbe Ergebnis zurück, unabhängig von den Aufrufparametern, mit diesen Ausnahmen: für die Konten DE, BLZ 10077777, Kontonr. 209299700 oder DE, BLZ 52051373, Kontonr. 5120710131 oder DE, BLZ 52051373, Kontonr. 5120710132 oder AT, BLZ 11000, Kontonummer 237571500 liefert auch der Dummy-Endpunkt das tatsächliche Ergebnis.

Testdaten: Hier finden Sie Testdaten für verschiedene Testfälle.

Authentifizierung: Basic Authentication mit demselben Benutzernamen und Passwort wie fürs Einloggen auf iban-bic.com.

Unterstützt GET und POST.

Eingabe

Parameter:

  • country: Der ISO-Ländercode mit zwei Buchstaben.
  • bankcode: Die nationale Bankleitzahl/sort code (GB, IE)/BC-Nummer (Schweiz).
  • account: Die nationale Kontonummer.
  • bic: Der BIC (oder zumindest ein ausreichend langer Unterstring), für die Länder GB, IE, NL, wo der BIC teilweise in die IBAN eingebaut wird. Wird für andere Länder ignoriert. Wenn Sie diese Angabe auch für IE, GB oder NL weglassen, versucht der Server, den BIC trotzdem herauszufinden, was aber nicht immer möglich ist bzw., für die Niederlande, nicht immer vollkommen zuverlässig ist.
  • legacy_mode:(Nur relevant für CH.) Wenn dieser Wert für ein Schweizer Konto auf 1 gesetzt wird, ruft der IBAN-Rechner nicht das externe Java-Programm von Swiss Interbank Clearing auf, sondern berechnet die IBAN selbst. Das Java-Programm validiert auch Kontonummern und verlangt, dass alle Zeichen (inklusive eventueller Punkte, Bindestriche etc.) korrekt eingegeben werden. Wird das Java-Programm nicht benutzt, geht es zwar schneller, aber die Kontonummern werden nicht validiert, und falsche IBANs sind wahrscheinlicher.

Ausgabe: die berechnete IBAN und Validierungsergebnisse

Die folgende Gruppe von Feldern enthält die berechnete IBAN und Validierungsergebnisse für die Eingaben:

  • iban: die berechnete IBAN. Selbst wenn ein Fehler aufgetreten ist, wird eventuell trotzdem hier eine IBAN ausgegeben.
  • result: 'passed' oder 'failed' - gibt an, ob eine IBAN berechnet werden konnte.
  • return_code: eine kondensierte Repräsentation der Ergebnisse der diversen Prüfungen. Nicht alle Prüfungen werden immer durchgeführt.

    Der return_code ist eine Zahl mit folgendem Wert:

    • Entweder 0, wenn alle unterstützten und durchgeführten Prüfungen erfolgreich waren.
    • Ansonsten die Summe einer oder mehrerer der folgenden Zahlen:

      • 1 = eine Unterkontonummer wurde automatisch hinzugefügt.
      • 2 = diese Kontonummer enthält keine Prüfsumme.
      • 4 = Prüfsumme wurde nicht geprüft.
      • 8 = Bankleitzahl wurde nicht geprüft.
      • 32 = Warnung: es könnte möglicherweise nötig sein, eine Unterkontonummer anzuhängen, aber ob es wirklich nötig ist, könnte nicht automatisch bestimmt werden. Bitte manuell prüfen.
      • 64 = Die Bank hat eine IBAN-Sonderregel veröffentlicht, aus der hervorgeht, dass für diese Kombination aus Kontonummer und Bankleitzahl keine IBAN berechnet werden soll.
      • 128 = Prüfsummenfehler in der Kontonummer.
      • 256 = Bankleitzahl wurde nicht im Verzeichnis gefunden.
      • 512 = Kontonummer hat die falsche Länge.
      • 1024 = Bankleitzahl hat die falsche Länge.
      • 4096 = es fehlen Eingabedaten (wie z. B. die Länderkennung).
      • 8192 = dieses Land wird (noch) nicht unterstützt.

    Interpretation, je nach Summe:

    • < 32. Korrekt;
    • 32 ≤ Summe ≤ 127. Das Ergebnis könnte korrekt sein, man sollte das aber manuell prüfen;
    • ≥ 128. Fehler.
    • = 65536. Es liegt ein Implementierungsfehler bei uns vor, und wir wären für einen Hinweis dankbar.

  • ibanrueck_return_code: reserviert für eine zukünftige Nutzung.
  • checks: ein Array, der die durchgeführten Prüfungen enthält. Kann Elemente enthalten wie 'length', 'bank_code', 'account_number'.
  • length_check'passed', 'failed for bank code' oder 'failed for account number' - gibt an, ob Kontonummer/Bankleitzahl die richtige Länge für dieses Land haben.
  • account_check:(nicht für alle Länder.) 'passed' oder 'failed'; für Deutschland ist auch der Wert 'passed after correction' möglich; in diesem Fall siehe das Feld 'alternative_account_number'. Das Feld account_check gibt über das Ergebnis der Prüfsummenvalidierung für die Kontonummer Auskunft. Wenn der Algorithmus unbekannt ist oder keine Prüfsumme existiert, ist das Ergebnis leer oder 'passed'.
  • bank_code_check: (nicht für jedes Land) die nationale Bankleitzahl wurde im Verzeichnis gefunden ('passed') oder nicht ('failed'); falls ein alternativer Bank-Code für die IBAN benötigt werden sollte, ist diese Information an das Wort "passed" angehängt.
  • bic_plausibility_check: (nur für NL.) Prüft, wieviele Konten der angegebenen Bank mit denselben Ziffern beginnen wie das angegebene Konto. Da auch das keine garantierte Sicherheit gibt, wird diese Prüfung für das Gesamtergebnis nicht berücksichtigt. Die Information in diesem Feld kann Ihnen aber dabei helfen, zu beurteilen, wie wahrscheinlich es ist, dass der richtige BIC-Code für das Konto angegeben wurde.
  • account_validation_method: Bezeichnung des Validierungs-Algorithmus für die nationale Kontonummer.
  • account_validation: für deutsche oder Schweizer Kontonummern, eine Erklärung der Validierung (auf deutsch)

  • IBANformat: Eine Beschreibung des IBAN-Formats für das jeweilige Land, z. B.: 'DEkk BBBB BBBB CCCC CCCC CC'.
  • formatcomment: eine Erklärung, wie die IBANformat-Angabe zu verstehen ist, z. B.: 'B = sort code (BLZ), C = account No.'

Ausgabe: Konto- und Bankinformationen (BIC, Bankadresse etc.)

Diese Felder enthalten weitere Informationen, die zu der berechneten IBAN gehören, wie z. B. den BIC-Code und Informationen über die Bank:

  • bic_candidates: ein Array von BICs, die zur angegebenen Bankleitzahl gehören können. Der Array kann leer sein oder eines oder mehrere Elemente enthalten. Jedes BIC-Element ist wiederum ein komplexer Datentyp, der die Attribute bic, wwwcount, sampleurl und city enthält.

    Interpretation:
    Interpretation: If

    • wwwcount > 0. Dieser BIC-Code wurde im Web gefunden, und zwar auf so vielen Seiten, wie durch wwwcount angegeben ist;
    • wwwcount = 0.Dieser BIC-Code kommt aus einem offiziellen Verzeichnis und ist dementsprechend zuverlässiger.
    • Auch wenn 'city' angegeben ist, stammt dieser BIC-Code aus einem offiziellen Verzeichnis.

  • country: Der ISO-Ländercode (die ersten beiden Zeichen der IBAN)
  • bank_code: die nationale Bankleitzahl, falls sie existiert. Für NL: BIC; für die Schweiz: BC-Nummer. Es gibt übrigens separate API-Funktionen fürs Ermitteln von niederländischen BICs und Schweizer BC-Nummern.
  • alternative_bank_code: einige wenige Banken betten eine andere Bankleitzahl in IBANs ein als die, die sie ihren Kunden zusammen mit dem Konto mitteilen. In so einem Fall wird die alternative Bankleitzahl in dieses Feld geschrieben, ansonsten bleibt es leer.
  • bank: Name der Bank, falls bekannt.
  • bank_address: Adresse der Bank, falls bekannt.
  • bank_url: URL der Website, falls bekannt.
  • branch: Name der Zweigstelle, falls bekannt.
  • branch_code: Zweigstellennummer, falls bekannt.
  • in_scl_directory: wenn mindestens ein BIC-Code zurückgeliefert wird (d.h., wenn der oben erwähnte Array bic_candidates nicht leer ist), wird dieses Feld auf 'yes' oder 'no', gesetzt, je nachdem ob der erste zurückgelieferte BIC-Code im SCL-Verzeichnis der Deutschen Bundesbank aufgelistet ist ('yes') oder nicht ('no'). Wenn kein BIC-Code zurückgeliefert wird, bleibt dieses Feld leer.
  • sct: Wenn in_scl_directory auf 'yes' gesetzt ist, enthält dieses Feld entweder 'yes' (falls ein SEPA Credit Transfer für den ersten zurückgelieferten BIC-Code unterstützt wird) oder 'no' (falls für den ersten zurückgelieferten BIC-Code kein SCT unterstützt wird). Wenn gar kein BIC-Code geliefert wird, bleibt dieses Feld leer.
  • sdd:Wenn in_scl_directory auf 'yes' gesetzt ist, enthält dieses Feld entweder 'yes' (falls ein SEPA Direct Debit für den ersten zurückgelieferten BIC-Code unterstützt wird) oder 'no' (falls für den ersten zurückgelieferten BIC-Code kein SDD unterstützt wird). Wenn gar kein BIC-Code geliefert wird, bleibt dieses Feld leer.
  • b2b: Wenn in_scl_directory auf 'yes' gesetzt ist, enthält dieses Feld entweder 'yes' (falls ein SEPA Business to Business für den ersten zurückgelieferten BIC-Code unterstützt wird) oder 'no' (falls für den ersten zurückgelieferten BIC-Code kein B2B unterstützt wird). Wenn gar kein BIC-Code geliefert wird, bleibt dieses Feld leer.
  • scc: Wenn in_scl_directory auf 'yes' gesetzt ist, enthält dieses Feld entweder 'yes' (falls SEPA Card Clearing für den ersten zurückgelieferten BIC-Code unterstützt wird) oder 'no' (falls für den ersten zurückgelieferten BIC-Code kein SCC unterstützt wird). Wenn gar kein BIC-Code geliefert wird, bleibt dieses Feld leer.
  • account_number: nationale Kontonummer.
  • alternative_account_number: für deutsche Konten muss manchmal eine Unterkontonummer an die Kontonummer angehängt werden, die in die IBAN eingebettet wird. Wenn das der Fall ist, erscheint die erweiterte Kontonummer in diesem Feld.
  • data_age: (nicht für alle Länder.) Alter der BIC- und anderen Bankdaten (d.h. Zeitpunkt der letzten bekannten Änderung, nicht Zeitpunkt der letzten Aktualisierung unserer Datenbank). Format: yyyymmdd.

Ausgabe: der Stand Ihres Benutzerkontos

  • balance: die Anzahl auf Ihrem Benutzerkonto verbleibender Berechnungen. Falls Sie Ihre Berechnungen im Nachhinein bezahlen, sind Berechnungen auch beim Erreichen von 0 weiter möglich.