CardTransactionProcessing

Dieses Dokument beschreibt die Web-Services Schnittstelle der dsb für die Kommunikation mit Zahlungsdienstleistern für die Kreditkartenabwicklung mit Echtzeitautorisierung.

Bei der Web-Services Schnittstelle handelt es sich um eine dokumenten-zentrische Schnittstelle. Das bedeutet, dass XML-Dokumente über SOAP-Nachrichten versendet werden und auch XML-Dokumente als Antwort zurückgemeldet werden. Das heißt aber auch, dass jede Nutzlast innerhalb eines XMLNachrichtenrahmens verpackt werden muss.

Alle Anfragen von außen werden über das Web-Service Portal der dsb an die entsprechenden Zielsysteme geleitet. Hierzu müssen im SOAP-Request die Header Elemente „service-object“ und „service-method“ immer gefüllt sein. Weitere Informationen zu diesem Konzept finden sich im Dokument „WsPortal – Nachrichten“ [1]. Dieses beschreibt auch wie der Zugriff technisch erfolgt.

Die eigentliche Schnittstellenbeschreibung ist so aufgebaut, dass im nächsten Abschnitt zuerst Objekt und Methoden beschrieben werden, einschließlich der Eintragungen, die im SOAP-Header vorgenommen werden müssen. Beispielhafte Nachrichten für Anfragen und die zurückgelieferten Antworten sind mit aufgeführt.

Der Abschnitt XML-Definitionen beschreibt alle verwendeten Tags sowie deren Syntax und Semantik.

Zusammenfassend werden anschließend einige technische und fachliche Voraussetzungen für die Anbindung von anderen Zahlungsdienstleistern über die XML-Schnittstelle sowie die Verwendung der Kreditkartenabwicklung mit Echtzeitautorisierung über andere Zahlungsdienstleister erläutert.

Da einige Daten in Form von Codewerten vorliegen, gibt der Abschnitt „Anhang“ schließlich Auskunft über alle verwendeten Codes und deren Bedeutung.

Der Client - die aufrufende Partei, z.B. eines der DSB-Systeme, ein externes Shopsystem oder eine CallCenter-Anwendung – ruft den DSB Web-Service auf und übergibt eine Anfrage ('Request') in der allgemeinen DSB-XML-Anfragestruktur an die benötigte Methode. Eine Übersicht und Beschreibung der zur Verfügung gestellten Methoden finden Sie im Abschnitt 2.3 Processing-Methoden.

Wichtig: Mit DSB ist vorab abzustimmen, welche Methoden eingesetzt werden sollen, damit auch in den Backend-Systemen AVS/3 und VHS die entsprechenden Einstellungen durchgeführt werden können.

DSB setzt die übergebenen Informationen in die dienstleisterspezifische Anfragestruktur um und sendet die Anfrage an den Dienstleister weiter. Nach Erhalt der XML-Antwort des Dienstleisters werden die Informationen in die allgemeine DSB-XML-Antwortstruktur umgesetzt und an den Client zurückübermittelt. Dazu gehört auch das Umsetzen von Fehlermeldungen des Dienstleisters und die Reaktion auf Systemfehler oder auch bestimmte formale/fachliche Fehler.

Vorteile dieser Vorgehensweise:

• Entkopplung des Clients vom Kreditkarten-Zahlungsdienstleister. Das erlaubt einen einfachen Austausch eines Zahlungsdienstleister ohne Änderungen im Client.
• Einfachere Schnittstelle für die Clients.
• Erhebliche Vereinfachung der Anbindung von neuen / weiteren Dienstleistern für den Client, da DSB die technische Implementierung und das Handling der Dienstleister-Spezifika übernimmt.

Neben den 'Processing'-Methoden, die Verarbeitungsanfragen an Zahlungsdienstleister senden, gibt es sog. 'Retrieval'-Methoden, d.h. solche zum Auffinden einer bestimmten Transaktion und den Responsedaten zu dieser Transaktion. Diese sind im folgenden Abschnitt 2.2 beschrieben. Bei diesen Methoden wird nur der DSB-Webservice aufgerufen, es erfolgt keine Anfrage an ein externes System.

Alle Methoden geben als Teil der Response den Request zu der übergebenen oder selektierten Transaktion zurück, mit einigen Anpassungen im Hinblick auf Datenschutz u. PCI-Richtlinien:

• Die Kreditkartennummer aus dem ursprünglichen Request wird nur in teilweise maskierter Form zurückgegeben.
• Die Kreditkartenprüfnummer (CV2) darf nicht gespeichert werden, es wird daher nur ein Kennzeichen abgelegt und zurückgegeben, ob eine CV2 im ursprünglichen Request mitgegeben wurde.

Nachdem der Endkunde den oder die gewünschten Artikel im E-Shop ausgewählt hat, folgt der Zahlungsvorgang auf der Bezahlseite des Shops. Anschließend erfolgen folgende Vorgänge:

1. Endkunde wählt bevorzugte Zahlart eines beliebigen Zahlungsdienstleiters (Payment Provider) aus.
2. Zahlung wird vom E-Shop bei dem der Zahlart entsprechenden Payment Provider angestoßen.
3. Payment Provider liefert dem E-Shop eine Redirect-URL zurück.
4. E-Shop gibt Redirect-URL direkt an den Browser des Endkunden weiter.
5. Zurückgegebene URL wird vom Browser des Endkunden aufgerufen und Endkunde gelangt auf die Bezahlseiten des Payment Providers.
   
   • Hier findet die eigentliche Zahlungsabwicklung statt.
6. Das Ergebnis dieser Zahlungsabwicklung (Zahlung durchgeführt oder abgebrochen) übermittelt der Payment Provider nun an den E-Shop.
7. E-Shop gibt der Situation entsprechend (Bestellabschluss oder bei nicht erfolgter Zahlung ggf. Angebot alternativer Zahlungsmittel) eine URL zurück.
8. Diese URL gibt der Payment Provider an den Browser des Endkunden weiter
9. Browser des Endkunden ruft diese URL auf.
10. alle vom Payment Provider in Schritt 6 zurückgelieferten Informationen über die Zahlungstransaktion werden an den DSB E-Payment Service „notifyTrx„ geleitet
    
    • Dieser speichert die Informationen ab und vergibt dazu eine eindeutige DSB Transaktions-ID, die für jeden Zahlungsvorgang einzigartig generiert wird. Sie wird innerhalb der DSB-Systeme übergeben und dient als Referenz bzw. Schlüssel für die abgelegten Daten der Zahlungstransaktion.
11. Diese DSB Transaktions-ID wird an den E-Shop zurückgeliefert.
12. E-Shop schickt die eigentliche Bestellung mitsamt der zurückgelieferten DSB TransaktionsID an DSB zur Durchführung der Bestellabwicklung.