DE ♦ EN

IBAN-BIC.com (Theano GmbH)  » Webservice  » Dokumentation  » Dokumentation: submit_iban

Passwort vergessen?

Kontakt,
Impressum

Neuer Kunde? Neu anmelden

Die Funktion submit_iban

Beispiel:
submit_iban("AT131490022010010999", "Max Pichler", "username", "password")
teilt uns mit, dass Max Pichler ein Bankkonto mit der IBAN AT131490022010010999 hat.

Alternative: Auch wenn Sie uns auf keinen Fall IBANs und Kontoinhaber schicken können, können Sie dennoch Punkte verdienen, indem Sie uns mithilfe von Hashes die Möglichkeit geben zu erkennen, dass eine bestimmte Kombination von IBAN und Kontoinhaber existiert. Dafür verwenden Sie bitte die Funktionen get_salts und submit_hashes.

Zweck: Wenn Sie eine für uns neue Kombination aus IBAN und ihrem Kontoinhaber in unsere Datenbank eintragen, schreiben wir Ihrem Konto 10 Punkte gut, die Sie später für Aufrufe von Funktionen wie z. B. validate_iban nutzen können. Die Funktion submit_iban führt folgende Schritte aus:

  • die IBAN validieren. Wenn sie nicht valide ist: Ende.
  • Aus dem Namen des Kontoinhabers einen oder mehrere Salt-Werte generieren. Wir verfolgen dabei das Ziel, dass auch bei einer leicht veränderten Schreibweise des Kontoinhabers noch mindestens ein gleicher Salz-Wert herauskommt, so dass wir später auch dann erkennen, dass die IBAN Herrn Pichler gehört, wenn sein Name beispielsweise als "M. Pichler" oder "Pichler, Max" statt "Max Pichler" angegeben wird.
  • Berechne aus jeder Kombination aus der IBAN und den im vorigen Schritt berechneten Salt-Werten einen SHA256-Hash.
  • Prüfe, ob einer der resultierenden Hashes schon in unserer Datenbank steht. Falls ja, haben Sie uns leider keine neue Information gegeben und verdienen daher keine Punkte.
  • Ansonsten: speichere die Hashes in unserer Tabelle von bekannten IBAN-Hashes ab. Die Salt-Werte oder der Name des Kontoinhabers oder die IBAN werden jedoch nicht dauerhaft gespeichert.
  • Da diese Kombination aus IBAN und Kontoinhaber uns noch unbekannt war, erhalten Sie 10 Punkte als Belohnung für die Erweiterung unserer Liste bekannter IBAN-Hashes.

Eingabeparameter:

  • IBAN: xsd:string
    Eine IBAN, von der Sie wissen, dass sie existiert und nicht nur formal richtig ist.
  • account holder: xsd:string
    Der Name der Firma oder Person, der das Konto mit der gegebenen IBAN gehört.
  • user: xsd:string
    Ihr Benutzername, mit dem Sie sich auf iban-bic.com einloggen.
  • password: xsd:string
    Ihr Passwort.

Rückgabewerte:

tns:SubmitIBANResStruct mit den folgenden Feldern:

  • result: "Thanks", wenn kein Fehler auftrat und uns die von Ihnen übermittelte Information neu war. Ansonsten: eine Fehlermeldung in natürlicher Sprache.
  • points: Die Anzahl Punkte, die Sie als Belohnung für die neue IBAN/Kontoinhaber-Kombination erhalten.
  • balance: Ihr neuer Kontostand.