Dokumentation

Für jede Version der SOAP-Schnittstelle (Produktion, Test, Entwicklung) können Sie die aktuelle Dokumentation lesen, indem Sie die SOAP-URL, z. B. https://ssl.ibanrechner.de/soap/, mit einem Web-Browser besuchen und dann auf den gewünschten Funktionsnamen klicken.

Hier finden Sie außerdem dieselbe Dokumentation für die in Produktion befindliche Version:

IBANs validieren, BBAN in IBAN umwandeln, Zusatzinformationen erhalten

• validate_iban (REST)/(SOAP): führt eine lange Reihe von Checks aus, liefert Informationen wie BIC, Bankname etc.
• validate_iban_dummy (REST): kostenloser Endpunkt zum Testen der Anbindung; liefert immer dasselbe Ergebnis einer IBAN-Validierung (unabhängig von der zu validierenden IBAN, aber kostenlos)
• validate_iban_bic: führt dieselben Checks wie validate_iban aus, und außerdem einen sehr sanften Test, ob die BIC zur IBAN gehören könnte. Für einen stringenteren Test nutzen Sie bitte validate_iban und prüfen Sie, ob Ihre BIC von validate_bic zurückgeliefert wird.
• calculate_iban(REST)/(SOAP): wandelt nationale Kontonummer in IBAN um, führt diverse Checks aus und liefert Zusatzinformationen.
• supported_countries: Funktion zum Nachschlagen, welche Länder von den obigen Funktionen wie gut unterstützt werden.
• find_bank: Internationale BLZ-/Bank-Suche

Andere Validierungen (Gläubiger-IDs, ABA routing code, BBAN...)

• calculate_iban validatiert auch die BBAN (nationale Kontonummer) als Nebeneffekt der Umwandlung in eine IBAN.
• validate_creditor_identifier Prüft die Prüfsumme.
• validate_aba Prüfsummencheck eines ABA routing code und Zusatzinformationen (soweit bekannt).

Unleserliche Zeichen in einer IBAN rekonstruieren

• restore_iban toleriert bis zu zwei Platzhalter in einer IBAN und liefert alle IBANs, die dem Muster entsprechen. Wenn nur eine IBAN passt, sind die fehlenden Zeichen erfolgreich wiederhergestellt.

Ein ausgefülltes und validiertes SEPA-Überweisungsformular als PDF-Datei erzeugen

• transfer_form erzeugt eine PDF-Datei mit einem SEPA-Überweisungsformular, das mit validierten IBANs und anderen Daten ausgefüllt ist, inklusive einem QR-Code fürs automatische Eingeben einer Überweisung in eine Banking-App.

QR-Code fürs automatische Füllen eines Überweisungsformulars erzeugen

• qrcode erzeugt einen QR-Code, den Sie auf Ihre Rechnung drucken können. Ihr Kunde kann damit auf Knopfdruck sein Überweisungsformular füllen, statt langwierig Dinge wie eine IBAN in seine Bank-Software abzutippen.

Mehrsprachiges HTML-Formular für BBAN-zu-IBAN-Umwandlung

• get_form liefert ein Formular fürs Eintragen und Umwandeln von Kontonummern in IBANs.
• get_dutch_banks nützlich für eine Auswahlliste mit niederländischen Banken.
• get_swiss_banks nützlich fürs Auswählen einer Schweizer Bank.
• supported_countries nützlich für eine Auswahlliste der unterstützten Länder.

Kontostand auffüllen durchs Übermitteln von IBAN/Kontoinhaber-Kombinationen

• submit_iban übermittelt eine IBAN/Kontoinhaber-Kombination. Diese wird jedoch nicht dauerhaft gespeichert; nur gesalzene Hashes werden gespeichert.
• submit_hashes übermittelt von Ihnen berechnete gesalzene Hashes, so dass Sie sicher sein können, dass wir wiklich keine IBANs und Kontoinhaber speichern. Ist allerdings etwas unhandlicher.
• get_salts: Hilfsfunktion für submit_hashes.