Dieses Dokument beschreibt die Web-Services Schnittstelle der dsb für die Kommunikation mit Zahlungsdienstleistern für die Integration von E-Payment Verfahren in die DSB-Systeme.

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 XML-Nachrichtenrahmens 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 hier. Dort ist beschrieben, 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 Anwendung der E-Payment Dienste ü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.

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.