In nur 2 Schritten


 

Schritt 1 Anmelden / Bestellen
Schritt 2
Einbinden in Ihre Anwendung

 

So einfach können Sie Bankdaten Ihrer Kunden auf Richtigkeit überprüfen!

Rückgabeparameter Format: ASCII


In diesem Artikel finden Sie eine Übersicht und Erklärungen der ASCII-Rückgabe-Parameter bei einem Aufruf des Bankdatenchecks.


Folgende Paramter werden von der ASCII-Version zurückgesendet.

BEISPIEL:

Version: 1.19.2568
VersionDatum: 2011-09-06
AbfrageFormat: ASCII
AbfrageIP: 127.0.0.1
AbfrageModus: VOLLVERSION
AbfrageID: 12345
AbfrageErgebnis: OK
CheckDatum: 2011-09-07
CheckZeit: 09:33:18
CheckBLZ: 33080030
CheckKontoNummer: XXXXXXXX
BundesbankDatenDatum: 2011-09-05
BundesbankDatenGueltig: 2011-12-04
ErgebnisBLZ: 1
ErgebnisKontoNummer: 1
ErgebnisIBAN: 1
ErgebnisKontoIBAN: DE6533080030XXXXXXXXX
ErgebnisMethode: 00
ErgebnisBankName: Dresdner Bank Wuppertal
ErgebnisBankBezeichnung: Dresdner Bank Wuppertal
ErgebnisBankPLZ: 42003
ErgebnisBankStadt: Wuppertal
ErgebnisKontoIBAN: XXXXXXXXXXXXXXXXXX
ErgebnisBankPAN: 28330
ErgebnisBankBIC: DRESDEFF332
ErgebnisKumuliert: 1


Parametername:

Beschreibung:

 

Version

Gibt die Versionsnummer des Webservices zurück. Sie können somit automatisch mitbekommen, wenn wir ein Update einspielen!

 

VersionDatum

Datum der Version

 

AbfrageFormat

Gibt das verwendete Antwortformat zurück, also entweder ASCII oder XML und sollte normal mit dem angeforderten Format übereinstimmen. Wird das XML-Format verwendet, weicht die gesamte Ausgabe natürlich von der ASCII-Ausgabe ab. (Die Rückgabeparameter im XML-Format)

 

AbfrageIP

Die IP-Adresse, von der der Webservice abgefragt wurde.

 

AbfrageModus

Der Modus, in dem der Webservice läuft. Also entweder "DEMO", falls die Anfrage mit einem falschen ProductLogin eingeht. Ansonsten "VOLLVERSION"

 

AbfrageID

Die Kunden-ID-Nummer (bzw. Ihr Produktlogin) z.B. "4711". Im Demomodus ist das Feld leer.

 

AbfrageErgebnis

Das generelle Ergebnis der Abfrage. Nicht das Ergebnis der Plausibilitätsprüfung der Kontodaten!
Abfrage korrekt = „OK“
Bei falschem Passwort = „WRONG_PASSWORD“
Bei falscher IP-Adresse = „IP_NOT_ALLOWED“
Bei internen Problemen = „FAILED“

 

CheckDatum

Das Systemdatum des Webservers auf dem der Webservice läuft

 

CheckZeit

Die Systemzeit des Webservers auf dem der Webservice läuft

 

CheckBLZ

Falls Bankdaten (BLZ & Kontonummer) übergeben wurden - Die Bankleitzahl, welche überprüft wurde – sollte mit der angefragten Bankleitzahl übereinstimmen. Wurde eine IBAN angefragt, so gibt es diesen Rückgabewert nicht.

 

CheckKontoNummer

Falls Bankdaten (BLZ & Kontonummer) übergeben wurden - Die Kontonummer, welche überprüft wurde – sollte mit der angefragten Kontonummer übereinstimmen. Wurde eine IBAN angefragt, so gibt es diesen Rückgabewert nicht.

 

CheckIBAN

Falls eine IBAN übergeben wurde - Die IBAN, welche überprüft wurde – sollte mit der angefragten IBAN übereinstimmen. Wurde keine IBAN angefragt gibt es diesen Rückgabewert nicht.

 

BundesbankDatenDatum

Datum an dem die Daten von der Bundesbank herausgegeben wurden.

 

BundesbankDatenGueltig

Datum wie lange die Daten gültig sind.

 

ErgebnisBLZ

Das Ergebnis der Bankleitzahlenprüfung. Es handelt sich hierbei um einen Integerwert mit folgenden Rückgabewerten:

-99 = nicht geprüft, da Abfrage im Demomodus
0 = Bankleitzahl ist ungültig
1 = Bankleitzahl ist gültig

Wenn die BLZ ungültig ist, kann die Kontonummer natürlich nicht überprüft werden. Sie wird dann auch "0" zurückliefern.

 

ErgebnisKontoNummer

Das Ergebnis der Kontonummernprüfung. Es handelt sich hierbei um einen Integerwert mit folgenden Rückgabewerten:
-99    = nicht geprüft, z.B.: da Abfrage im Demomodus
–9    = Schwerwiegender, interner Webservice-Fehler
–8    = Schwerwiegender, interner Webservice-Fehler
–7    = Schwerwiegender, interner Webservice-Fehler
–6    = Schwerwiegender, interner Webservice-Fehler
–5    = ungültige Bankleitzahl
–4    = ungültige Kontonummer
0     = Bankleitzahl oder Kontonummer ist ungültig
1    = Bankleitzahl und Kontonummer ist gültig
2     = Kontonummer kann nicht überprüft werden
Normalerweise sollten Sie nur die Rückgabewerte 0 oder 1 bzw. 2, oder im Demomodus noch „–99“ erhalten.
Erhalten Sie –6 bis –9 als Rückgabewert, nehmen Sie bitte mit Portunity Kontakt auf und nennen dabei das zurückgegebene Systemdatum und Ihre IP-Adresse.
(siehe bitte PDF Dokumentation)

ErgebnisKumuliert

Zusammengefasstes Ergebnis: (ab Version: 1.19)
0 =    Prüfergebnis nicht als in Ordnung zu werten
1 =    Prüfergebnis als in Ordnung zu werten.
    Wenn „ErgebnisBLZ“ = „1“ und
    „ErgebnisKontoNummer“ = „1“ oder = „2“ (siehe ggf. PDF Dokumentation).

 

ErgebnisIBAN

Das Ergebnis der IBAN-Prüfziffer - Prüfung. Es handelt sich hierbei um einen Integerwert mit folgenden Rückgabewerten:

-99 = nicht geprüft (z.B. weil nicht für Demomodus autorisiert)
0 = IBAN Prüfziffer ist ungültig
1 = IBAN Prüfziffer ist gültig

Hinweis: Dieser Wert ist lediglich eine Syntaxprüfung der übergebenen der IBAN, nicht die Plausibilitätsprüfung des eigentlichen Kontos! Zur Plausibilitätsprüfung des hinter der IBAN befindlichen Kontodaten fragen Sie bitte den Rückgabewert: "ErgebnisKontoNummer" ab (Momentan nur für deutsche Bankkonten verfügbar).

 

ErgebnisKontoIBAN

Die International Bank Account Number des Kontos für den Internationalen Zahlungsverkehr.
Portunity weist ausdrücklich darauf hin, das nur die Banken selber gültige IBANs herausgeben. Portunity übernimmt keine Gewähr im Falle einer falschen IBAN und für Schäden die durch die Benutzung entstehen.

 

ErgebnisBerechneteBLZ

Bei übergebener IBAN wird die daraus resultierende BLZ berechnet und zurückgegeben.

 

ErgebnisBerechneteKontoNummer

Bei übergebener IBAN wird die daraus resultierende Kontonummer berechnet und zurückgegeben.

 

ErgebnisMethode

Die Nummer des verwendeten Prüfalgorithmuses lt. Beschreibung der Bundesbank.
Diese kann aus zwei Teilen, der Basisnummer z.B. „57“ oder „A0“ sowie einem optionalen Suffix z.B.: „b“, bestehen „57b“

 

ErgebnisBankName

Der Name der Bank von der die Bankleitzahl stammt.

 

ErgebnisBankBezeichnung

Die Kurzbezeichnung der Bank.

 

ErgebnisBankPLZ

Die Postleitzahl der Bank.

 

ErgebnisBankStadt

Die Stadt der Bank.

 

ErgebnisBankPAN

Die Institutsnummer der Bank für den internationalen Kartenzahlungsverkehr mittels Bankkundenkarten.

 

ErgebnisBankBIC

Der Bank Identifier Code.



1 Für einige Kontonummern gibt es keine Prüfziffernkontrolle, die Kontonummern sind aber als richtig anzusehen. Die aktuelle Liste der Methoden finden Sie in der aktuellen PDF-Version der Dokumentation.


zurück