Kreditkarten - Server-2-Server Integration

Multiexcerpt

MultiExcerptName	3DS2Short1

Eine 3DS 2.0 Zahlungssequenz kann aus den folgenden verschiedenen Aktivitäten bestehen:

Versionierung
- Anfrage von ACS- und DS-Protokol-Version(en), die mit dem Kartenkontenbereich korrespondieren sowie einer optionalen 3DS Method URL

3DS Methode
- Verbindet den Browser des Karteninhabers mit dem ACS des Issuers, um zusätzliche Browserdaten zu erhalten
Authentisierung
- Übermittlung der Authentisierungs-Anfrage an den ACS des Issuers
Challenge
- Challenge des Karteninhabers, falls angeordnet
Autorisierung
- Autorisierung der authentisierten Transaktion beim Acquirer

Server-2-Server Sequenzdiagramm

Multiexcerpt

MultiExcerptName	3DS2Short2

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Server-2-Server Sequence Diagram
PageWithExcerpt	EN:Server-2-Server Integration

Info

Beachten Sie bitte, dass die Kommunikation zwischen Client und Access Control Server (ACS) über iFrames implementiert ist. Daher kommen die Antworten in einem HTML-Subdokument an und Sie können entsprechende Event-Listener in Ihrem Root-Dokument einrichten.

Alternativ könnten Sie alleinig auf die asynchronen Benachrichtigungen an ihr Backend vertrauen. In jenen Fällen müssen Sie eventuell Methoden wie Long Polling, SSE oder Websockets zum Update des Clients in Betracht ziehen.

Table of Contents

Multiexcerpt include

MultiExcerptName	Link_EMV3DS
DisableCaching	true
PageWithExcerpt	Reuse API

Multiexcerpt include

MultiExcerptName	Link_APIPlayground
DisableCaching	true
PageWithExcerpt	Reuse API

Initiierung der Zahlung

Multiexcerpt

MultiExcerptName	3DS2Short3

Die anfängliche Anfrage an das

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Platform-Name
PageWithExcerpt	Wording

ist unabhängig vom zugrundeliegenden 3DS-Protokoll gleich.

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Payment Initiation
PageWithExcerpt	EN:Server-2-Server Integration

Um eine Server-zu-Server 3-D Secure Kartenzahlungssequenz zu starten, senden Sie bitte folgende Schlüssel-Wert-Paare an

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

direct.aspx.

Aufruf-Elemente

Hinweis: Bei einer vom Händler initiierten, wiederkehrenden Zahlung sind die JSON-Objekte (außer credentialOnFile und card), die URLNotify und die TermURL keine Pflichtparameter, da kein 3D Secure und auch keine Risikobewertung durch die kartenausgebende Bank stattfindet und das Ergebnis der Zahlungsanfrage direkt in der Response mitgeteilt wird.

Table Filter

inverse	false
default	Description
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1640843862830_-816148390
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	request_elements
PageWithExcerpt	EN:Server-2-Server Integration

Antwort-Elemente

Table Filter

inverse	false
default	Description
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1640843891588_429270583
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	response_elements
PageWithExcerpt	EN:Server-2-Server Integration

versioningData

Das Objekt versioningData gibt die EMV 3DS Protokoll-Versionen (d.h. 2.1.0 oder höher) an, die vom Access Control Server des Issuers unterstützt werden.

Wenn die entsprechenden Felder der Protokoll-Version NULL sind, bedeutet dies, dass der BIN-Bereich des Karten-Issuers nicht für 3DS 2.0 registriert ist und ein Fallback auf 3DS 1.0 für Transaktionen erforderlich ist, die unter den Geltungsbereich der PSD2 SCA fallen.

Achten Sie beim Zerlegen von versioningData bitte auch auf das Subelement errorDetails, das den Grund angibt, falls einige Felder nicht ausgefüllt sind (z.B. Ungültige Kontonumber des Karteninhabers übergeben, nicht verfügbare Kartenbereichsdaten, Fehler beo Codieren/Serialisieren der 3DS Methoden-Daten usw.)

BASEURL=

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	versioningdata
PageWithExcerpt	EN:Server-2-Server Integration

3DS Methode

Die 3DS Methode ermöglicht das Erfassen zusätzlicher Browserinformationen durch einen ACS vor Erhalt der Authensisierungsanfrage (AReq), um die Risikobeurteilung der Transaktion zu erleichtern. Die Unterstützung der 3DS Methode ist optional und liegt im Ermessen des Issuers.

Das Objekt versioningData enthält einen Wert für threeDSMethodURL. Der Händler sollte die 3DS Methode über einen versteckten HTML-iFrame im Browser des Karteninhabers aufrufen und ein Formular mit einem Feld namens threeDSMethodData über HTTP POST an die ACS 3DS Methoden-URL senden.

3DS Methode: `threeDSMethodURL`

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	threeDSMethodURL
PageWithExcerpt	EN:Server-2-Server Integration

Beachten Sie bitte, dass die threeDSMethodURL vom

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Platform-Name
PageWithExcerpt	Wording

ausgefüllt wird, falls der Issuer die 3DS Methode nicht unterstützt. Der 3DS Methoden-Formular-Post wie unten dargestellt muss unabhängig davon ausgeführt werden, ob dies vom Issuer unterstützt wird. Das ist notwending, um die direkte Kommunikation zwischen dem Browser und dem

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Platform-Name
PageWithExcerpt	Wording

im Falle einer angeordneten Challenge oder eines reibungslosen Ablaufs zu erleichtern.

3DS Method: Keine Issuer`threeDSMethodURL`

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	No issuer threeDSMethodURL
PageWithExcerpt	EN:Server-2-Server Integration

3-D Secure Method Form Post

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	3ds_method
PageWithExcerpt	EN:Server-2-Server Integration

Der ACS interagiert mit dem Browser des Karteninhabers über den HTML-iFrame und speichert dann die zutreffenden Werte mit der 3DS Server Transaction ID für die Verwendung, wenn eine nachfolgende Authentisierungs-Nachricht empfangen wird, welche die gleiche 3DS Server Transaction ID enthält.

Info

title	Netcetera 3DS Web SDK

Sie können nach eigenem Ermessen die Operationen init3DSMethod oder createIframeAndInit3DSMethod vom nca3DSWebSDKverwenden, um die 3DS Methode zu initialisieren. Bitte beachten Sie dazu das Integrations-Handbuch unter https://mpi.netcetera.com/3dsserver/doc/current/integration.html#Web_Service_API.

Nachdem die 3DS Methode abgeschlossen ist, weist der ACS den Browser des Karteninhabers über das iFrame-Antwortdokument an, threeDSMethodData als ein verstecktes Formularfeld an die 3DS Method Notification URL zu übermitteln.

ACS Response Document

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	acs_response
PageWithExcerpt	EN:Server-2-Server Integration

3-D Secure Method Notification Form

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	3ds_method_notification_form
PageWithExcerpt	EN:Server-2-Server Integration

Note

Beachten SIe bitte, dass die threeDSMethodNotificationURL wie sie in den Base64-codierten threeDSMethodData eingebettet ist, auf das

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Platform-Name
PageWithExcerpt	Wording

weist und nicht verändert werden darf. Die Händler-Benachrichtigung wird an die URLNotify geliefert, wie sie in der Originalanfrage übermittelt oder für die MerchantID im

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Platform-Name
PageWithExcerpt	Wording

konfiguriert ist.

Authentisierung

Wenn die 3DS-Methode vom ACS des Issuers unterstützt wird und vom Händler aufgerufen wurde, setzt das

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Platform-Name
PageWithExcerpt	Wording

automatisch mit der Authentisierungsanfrage fort, nachdem die 3DS-Methode abgeschlossen ist (d.h. 3DS Methoden-Benachrichtigung).

Das Ergebnis der Authentisierung wird per HTTP POST an die URLNotify übertragen. Es kann anzeigen, dass der Karteninhaber authentisiert worden ist oder dass eine weitere Interaktion des Karteninhabers (d.h. Challenge) für den Abschluss der Authentisierung erforderlich ist.

Falls für den Karteninhaber eine Challenge für nötig angesehen ist, überträgt das

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Platform-Name
PageWithExcerpt	Wording

ein JSON-Objekt im Body der HTTP Browser-Antwort mit den Elementen acsChallengeMandated, challengeRequest, base64EncodedChallengeRequest und acsURL. Anderenfalls setzt das

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Platform-Name
PageWithExcerpt	Wording

in einem reibungslosen Ablauf automatisch fort und antwortet dem Browser des Karteninhabers, sobald die Autorisierung abgeschlossen ist.

Karteninhaber-Challenge: Browser-Antwort

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Challenge - Browser Response
PageWithExcerpt	EN:Server-2-Server Integration

Browser Challenge-Antwort

Datenelemente

Table Filter

inverse	false
default	Description
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1640844658232_1056396307
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	challenge_response
PageWithExcerpt	EN:Server-2-Server Integration

Schema Browser Challenge-Antwort

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	schema
PageWithExcerpt	EN:Server-2-Server Integration

Beispiel Browser Challenge-Antwort

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	sample
PageWithExcerpt	EN:Server-2-Server Integration

Authentisierungs-Benachrichtigung

Die Datenelemente der Authentisierungs-Benachrichtigung stehen in folgender Tabelle.

Table Filter

inverse	false
default	Description
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1640844737143_-711157844
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	authentification_notification
PageWithExcerpt	EN:Server-2-Server Integration

Browser Challenge

Wenn eine Challenge für nötig angesehen wird (siehe challengeRequest), erfolgt die Browser Challenge im Browser des Karteninhabers. Zum Erzeugen einer Challenge ist es erforderlich, den Wert base64EncodedChallengeRequest über ein HTML-iFrame an die ACS URL zu posten.

Challenge-Anfrage

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	challenge_request
PageWithExcerpt	EN:Server-2-Server Integration

Sie können die Operationen init3DSChallengeRequest oder createIFrameAndInit3DSChallengeRequest aus dem nca3DSWebSDK verwenden, um die Challenge-Nachricht an den Browser des Karteninhabers zu übermitteln.

3DS Challenge-Anfrage initialisieren - Beispiel

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	init_challenge_request
PageWithExcerpt	EN:Server-2-Server Integration

Sobald die Challenge des Karteninhabers abgeschlossen, abgebrochen oder per Zeitüberschreitung beendet ist, weist der ACS den Browser an, die Ergebnisse per Post an die in der Challenge-Anfrage angegebene Benachrichtigungs-URL zu senden und eine Ergebnis-Anfrage (RReq) über den Directory Server an den 3DS Server zu senden.

Note

Beachten Sie bitte, dass die in der Challenge-Anfrage übergebene Benachrichtigungs-URL auf das

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Platform-Name
PageWithExcerpt	Wording

zeigt und nicht verändert werden darf.

Autorisierung

Nachdem die erfolgreiche Authentisierung des Karteninhabers oder der Nachweis der versuchten Authentisierung/Verifizierung bereitgestellt ist, setzt das

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Platform-Name
PageWithExcerpt	Wording

die Zahlungsautorisierung automatisch fort.

Falls die Authentisierung des Karteninhabers nicht erfolgreich war oder der Nachweise der versuchten Authentisierung/Verifizierung nicht bereitgestellt werden kann, setzt das

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Platform-Name
PageWithExcerpt	Wording

nicht mit einer Autorisierungsanfrage fort.

In beiden Fällen liefert das

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

eine Benachrichtigung mit dem Ergebnis der Authentifizierung an die vom Händler angegebene URLNotify mit den Datenelementen gemäß nachstehender Tabelle.

Zahlungs-Benachrichtigung

Table Filter

inverse	false
default	Description
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1640844935634_-220508898
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	payment_notification
PageWithExcerpt	EN:Server-2-Server Integration

Browser Zahlungs-Antwort

Zusätzlich werden nachstehende Datenelemente im JSON-Format im Body der HTTP-Antwort zum Browser des Karteninhabers übertragen. Beachten Sie bitte, dass die Datenelemente (d.h. MID, Len, Data) base64-codiert sind.

Datenelemente

Table Filter

inverse	false
default	Description
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1640844979680_1524754305
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	payment_response
PageWithExcerpt	EN:Server-2-Server Integration

Schema

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	response_schema
PageWithExcerpt	EN:Server-2-Server Integration

Händler sollten diese Datenelemente zur Entschlüsselung und für den Abgleich mit der Zahlungs-Benachrichtigung am ihren Server weiterleiten. Basierend auf dem Zahlungsergebnis kann der Händler-Server eine entsprechende Antwort an den Browser des Karteninhabers senden (z.B. Erfolgsseite).

Entschlüsseltes Objekt Data

Table Filter

inverse	false
default	Description
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1640845039652_1135070337
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	decrypted_data
PageWithExcerpt	EN:Server-2-Server Integration

Beispiel für entschlüsseltes Objekt Data

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	sample_decrypted_data
PageWithExcerpt	EN:Server-2-Server Integration

Space shortcuts

Page tree

Versions Compared

Old Version 9

New Version Current

Key

Kreditkarten - Server-2-Server Integration

Server-2-Server Sequenzdiagramm

Initiierung der Zahlung

Aufruf-Elemente

Antwort-Elemente

versioningData

3DS Methode

3DS Methode: `threeDSMethodURL`

3DS Method: Keine Issuer`threeDSMethodURL`

3-D Secure Method Form Post

ACS Response Document

3-D Secure Method Notification Form

Authentisierung

Karteninhaber-Challenge: Browser-Antwort

Browser Challenge-Antwort

Datenelemente

Schema Browser Challenge-Antwort

Beispiel Browser Challenge-Antwort

Authentisierungs-Benachrichtigung

Browser Challenge

Challenge-Anfrage

3DS Challenge-Anfrage initialisieren - Beispiel

Autorisierung

Zahlungs-Benachrichtigung

Browser Zahlungs-Antwort

Datenelemente

Schema

Entschlüsseltes Objekt Data

Beispiel für entschlüsseltes Objekt Data

Paygate

Computop

Help

Intranet Tools

Space shortcuts

Page tree

Page History

Versions Compared

Old Version 9

New Version Current

Key

Kreditkarten - Server-2-Server Integration

Server-2-Server Sequenzdiagramm

Initiierung der Zahlung

Aufruf-Elemente

Antwort-Elemente

versioningData

3DS Methode

3DS Methode: threeDSMethodURL

3DS Method: Keine IssuerthreeDSMethodURL

3-D Secure Method Form Post

ACS Response Document

3-D Secure Method Notification Form

Authentisierung

Karteninhaber-Challenge: Browser-Antwort

Browser Challenge-Antwort

Datenelemente

Schema Browser Challenge-Antwort

Beispiel Browser Challenge-Antwort

Authentisierungs-Benachrichtigung

Browser Challenge

Challenge-Anfrage

3DS Challenge-Anfrage initialisieren - Beispiel

Autorisierung

Zahlungs-Benachrichtigung

Browser Zahlungs-Antwort

Datenelemente

Schema

Entschlüsseltes Objekt Data

Beispiel für entschlüsseltes Objekt Data

3DS Methode: `threeDSMethodURL`

3DS Method: Keine Issuer`threeDSMethodURL`