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.

The general flow of a credit card transaction query is illustrated below:

The client, which could be a shop or call-center application, passes a request to the DSB Web service: a summary and description of the methods can be found in section 0 - Processing methods. The DSB web service then transforms the request into the configured credit card payment provider’s request structure and forwards this to them. The response from the payment provider is likewise transformed from the card payment provider’s response structure to the DSB XML response structure.

Important: You have to inform dsb in advance which methods should be used. The backend systems AVS/3 and VHS must be configured too.

The advantages of this method of connection are:

• The decoupling of the client to credit card payment providers, allowing clients to connect to other payment providers more easily. Differences between the payment providers is handled by the DSB layer as much as possible.
• Simpler interface for clients
• Providing the foundation from which new payment providers can be connected.

Alongside ‚Processing methods‘ that send requests to payment providers, there are ‚Retrieval methods‘ that can collect previously sent interactions between servers. These are described in section 2.2. As illustrated above, these requests only interact with the DSB web services i.e. no other external system will be queried.

All methods are able to return the request made upon the server as part of the response. Due to PCI rules however, the Credit Card Facade makes the following changes to sensitive data: