Page History

3D Secure (3DS) ist eine Authentifizierungsmethode, die zusätzlichen Schutz vor Betrug bei Online-Kartenzahlungen bietet.Wenn Sie Zahlungen innerhalb des Europäischen Wirtschaftsraums akzeptieren, ist die Authentifizierung der Transaktionen mit 3D Secure zwingend erforderlich, um die Anforderungen der PSD2 SCA (Strong Customer Authentication) zu erfüllen.

3D Secure Integrationsoptionen

Hosted Payment Page oder gehostete Formulare

Wenn Sie die Hosted Payment Page oder gehostete Formulare des

Direkte Integration

Für Händler, die die direkte Integration verwenden, hängt die Implementierung von 3DS davon ab, wie Sie den Authentifizierungsprozess handhaben:

Vom Händler verwaltete 3DS-Authentifizierung

Wenn Sie den 3DS-Authentifizierungsprozess unabhängig verwalten, bevor Sie die Zahlungsanforderung an

{
    "acsProtocolVersion": "2.2.0",
    "authenticationValue": "AAABBIcWERFgUFgUQklFQRE=",
    "eci": "02",
    "threeDSServerTransID": "55570cf-bt5b-43fe-bd0d-2trr3427401c",
    "acsXID": "34565040-e95d-4f55-9aa1-d48d1234acd4",
    "dsTransID": "4347f607-d631-4ad5-34564533cadce558",
    "intermediateStatus": "Y",
    "finalStatus": "Y",
    "challengeRequestInd": "01"
}

Vom 

Multiexcerpt include
SpaceWithExcerpt DE MultiExcerptName Platform-Name PageWithExcerpt Wording

verwaltete 3DS-Authentifizierung

Dieser Abschnitt beschreibt den Prozessablauf für Händler, die den 3DS-Authentifizierungsprozess von

Prozessablauf

1. Der Kunde geht mit Kartenzahlung als bevorzugter Zahlungsmethode in Ihrem Webshop zur Kasse und übermittelt alle Kartendaten.

2. Ihr Frontend stellt eine Zahlungsanforderung an Ihr Backend.

3. Ihr Backend machte einen Aufruf Zahlung anlegen an das

Versionierung:

4. Das

5. Das

6. Das

{
    "threeDSServerTransID": "f049e8fb-5d93-1234-b995-3eaf05cef06a",
    "acsStartProtocolVersion": "2.2.0",
    "acsEndProtocolVersion": "2.2.0",
    "dsStartProtocolVersion": "2.2.0",
    "dsEndProtocolVersion": "2.2.0",
    "threeDSMethodURL": "https://testacsserver.com/3ds-method",
    "threeDSMethodDataForm": "eyJ0aHJlZURTTWV0aG9kTm90aWZpY2F0aW9uVVJMIjoiaHR0cHM6Ly93d3cuY29tcHV0b3AtcGF5Z2F0ZS5jb20vY2JUaHJlZURTLmFzcHg_YWN0aW9uPW10aGROdGZuIiwidGhyZWVEU1NlcnZlclRyYW5zSUQiOiJmMDQ5ZThmYi01ZDkzLTQ2MTAtYjk5NS0zZWFmMDVjZWYwNmEifQ",
    "threeDSMethodData": {
        "threeDSMethodNotificationURL": "https://www.computop-paygate.com/cbThreeDS.aspx?action=mthdNtfn",
        "threeDSServerTransID": "f049e8fb-5d93-4610-b995-3eaf05cef06a"
    }
}

Die Gründe für fehlende Parameter in versioningData finden Sie im Objekt paymentMethods.card.versioningData.errorDetails.

3DS-Methode: Die 3DS-Methode ist ein optionaler Schritt im 3DS-Authentifizierungsablauf. Sie ermöglicht es dem ACS des Kartenausstellers, zusätzliche Browser-/Geräteinformationen zu erfassen, bevor die eigentliche Authentifizierungsanfrage (AReq) gesendet wird.Diese Daten ermöglichen dem ACS eine genauere Risikobewertung der Transaktion.

7. Basierend auf der erhaltenen Versionierungsantwort sollte der Prozess 3DS-Methode aufgerufen werden. Dazu muss Ihr Backend Ihrem Frontend die aus der Versionierungsantwort erhaltenen threeDSMethodData und threeDSMethodURL bereitstellen. Ihr Frontend sollte einen versteckten Iframe mit einem Formular mit einem versteckten Eingabefeld für threeDSMethodData erstellen und an threeDSMethodURL übermitteln. Die threeDSMethodData sollten Base64-kodiert gesendet werden und können direkt aus threeDSMethodDataForm in der Versionierungsantwort abgerufen werden. Nachfolgend sehen Sie ein Beispiel für die Implementierung: 

<form name="threeDSMethodForm" method="POST" action="https://testacsserver.com/3ds-method">
  <input type="hidden" name="threeDSMethodData" value="eyJ0aHJlZURTU2VydmVyVHJhbnNJRCI6IjNhYzdjYWE3LWFhNDItMjY2My03OTFiLTJhYzA1YTU0MmM0YSIsInRocmVlRFNNZXRob2ROb3RpZmljYXRpb25VUkwiOiJ0aHJlZURTTWV0aG9kTm90aWZpY2F0aW9uVVJMIn0">
</form>

Wenn der Issuer den Prozess 3DS-Methode nicht untestützt, füllt das

8. Ihr Frontend sendet das versteckte Formular an die ACS 3DS Method URL, die es ACS ermöglicht, alle erforderlichen Informationen zu erfassen.

9. ACS antwortet auf die Anfrage 3DS-Methode mit einen HTML-Dokument.

10. Das HTML-Dokument enthält JavaScript, das automatisch ein verstecktes Formular mit den threeDSMethodData erzeugt und an die threeDSMethodNotificationURL sendet, die vom

Authentifizierung:

11. Nach Erhalte der 3DS-Abschlussbenachrichtigung sendet das

12. Der 3DS-Server sendet eine Authentifizierungsanforderung an den Directory-Server.

13. Der Directory-Server sendet eine Authentifizierungsanforderung an ACS

14. ACS sendet eine Authentifizierungsantwort an den Directory-Server zurück

15. Der Directory-Server leitet die Antwort an den 3DS-Server weiter

16. Der 3DS-Server leitet die Antwort an das

17.

18.

ChallengeWindowSize wird anhand der in browserInfo bereitgestellten Viewport-Abmessungen berechnet. Wenn der Händler kleinere Abmessungen angibt, werden diese an das ACS übermittelt. Obwohl die meisten ACS für ihre SCA/OTP-Ansichten ein responsives Design verwenden, gibt es keine Garantie dafür, dass jede Größe funktioniert oder optisch ansprechend dargestellt wird.

{
  "threeDSServerTransID": "f049e8fb-5d93-1234-b995-3eaf05cef06a",
  "acsChallengeMandated": true,
  "acsDecConInd": false,
  "acsOperatorID": "10024942",
  "acsReferenceNumber": "3DS_LOA_ACS_HIIN_020200_00553",
  "acsTransID": "70283ff7-df85-44be-b157-3bc6f8a31b89",
  "acsURL": "https://testacsserver.com/3ds-method",
  "dsReferenceNumber": "VISA.V 17 0003",
  "dsTransID": "2f15b09e-b915-4d5e-9f04-239ed985f3bb",
  "messageType": "ARes",
  "messageVersion": "2.2.0",
  "transStatus": "C",
  "challengeRequest": {
      "threeDSServerTransID": "f049e8fb-5d93-1234-b995-3eaf05cef06a",
      "acsTransID": "70283ff7-df85-44be-b157-3bc6f8a31b89",
      "challengeWindowSize": "04",
      "messageVersion": "2.2.0",
      "messageType": "CReq"
  },
  "base64EncodedChallengeRequest": "eyJtZXNzYWdlVHlwZSI6IkNSZXEiLCJ0aHJlZURTU2VydmVyVHJhbnNJRCI6ImYwNDllOGZiLTVkOTMtNDYxMC1iOTk1LTNlYWYwNWNlZjA2YSIsImFjc1RyYW5zSUQiOiI3MDI4M2ZmNy1kZjg1LTQ0YmUtYjE1Ny0zYmM2ZjhhMzFiODkiLCJjaGFsbGVuZ2VXaW5kb3dTaXplIjoiMDQiLCJtZXNzYWdlVmVyc2lvbiI6IjIuMi4wIn0"
}

Challenge:

19. Basierend auf der erhaltenen Authentifizierungsantwort sollte Ihr Frontend eine Challenge-Anfrage erzeugen. Dazu dekodieren Sie die Authenfizierungsantwort und erfassen die in base64EncodedChallengeRequest und acsURL vorhandenen Werte. Senden Sie base64EncodedChallengeRequest über einen versteckten HTML- Iframe , der ein Formular mit verstecktem Eingabefeld enthält, an acsURLder Größe x (entweder challengeWindowSize oder go 05; 100%*100%). Nachfolgend sehen Sie ein Beispiel für die Implementierung: 

<form name="challengeRequestForm" method="POST" action="https://testacsserver.com/3ds-method">
  <input type="hidden" name="creq" value="eyJtZXNzYWdlVHlwZSI6IkNSZXEiLCJ0aHJlZURTU2VydmVyVHJhbnNJRCI6ImYwNDllOGZiLTVkOTMtNDYxMC1iOTk1LTNlYWYwNWNlZjA2YSIsImFjc1RyYW5zSUQiOiI3MDI4M2ZmNy1kZjg1LTQ0YmUtYjE1Ny0zYmM2ZjhhMzFiODkiLCJjaGFsbGVuZ2VXaW5kb3dTaXplIjoiMDQiLCJtZXNzYWdlVmVyc2lvbiI6IjIuMi4wIn0">
</form>

20. ACS rendert das Challenge-Fenster im Browser.

21. Der Kunde absolviert die Challenge.

22. ACS benachrichtigt den Directory-Server über das Ergebnis der Challenge mittels Ergebnisanforderungsnachricht (RReq).

23. Der Directory-Server leitet die RReq an den 3DS-Server weiter.

24. Der 3DS-Server leitet das Challenge-Ergebnis an das

25. Der 3DS-Server bestätigt RReq mit einer Ergebnisantwort (RRes) an den Directory-Server.

26. Der Directory-Server leitet RRes an ACS weiter.

27. ACS stellt dem Browser zusätzlich die Challenge-Antwort als Antwort auf „Challenge senden“ (Schritt 21) zur Verfügung.Ihr Frontend sollte die an das Iframe zurückgegebene Challenge-Antwort abhören.

28. Sobald die Challenge-Antwort eingegangen ist, sendet Ihr Frontend eine Challenge-Antwort-Benachrichtigungsanforderung an das

{
  "messageType": "CRes",
  "messageVersion": "2.2.0",
  "threeDSServerTransID": "f049e8fb-5d93-1234-b995-3eaf05cef06a",
  "acsTransID": "70283ff7-df85-44be-b157-3bc6f8a31b89",
  "challengeCompletionInd": "Y",
  "transStatus": "Y"
}

Autorisierung:

29.

30. Der Acquirer übermittelt die Autorisierungsantwort an

31.

32.

33. Ihr Frontend ruft die Rücksprung-URL Ihres Shops mit payId von Ihrem Backend auf.

34. Ihr Backend führt Zahlungsdetails abfragen mit payId am

35.

36. Ihr Backend rendert je nach responseCode der Transaktion eine Erfolgs- oder Fehlerseite.