3DS2 - Challenge authentication, with the 3DS Method
To test this scenario, use one of the card numbers below:
| CARD | Expiry date | Label |
|---|---|---|
| 4970110000001003 | To be chosen | VISA |
| 5100010000000106 | To be chosen | MASTERCARD |
| 375900000010015 | To be chosen | AMEX |
Exchange flow
1. Call to Web Service PCI/Authentication/CreateSession with an enrolled 3DS2 card.
{
"amount": "990",
"currency": "EUR",
"transactionCategory": "PAYMENT",
"productType": "GOODS_OR_SERVICE_PURCHASE",
"merchant": {
"mid":""
},
"paymentForm": {
"pan": "4970110000001003",
"expiryMonth": "11",
"expiryYear": "23",
"networkPreference": "VISA"
},
"customer": {
"email": "<sample@example.com>"
},
"protocolRequest": {
"name": "THREEDS",
"version": "2"
},
"ianTargetUrl": "<https://merchant.ian.com>"
}Response
{
"webService":"PCI/Authentication/CreateSession",
"version":"V4",
(...)
"answer":{
"operationSessionId":"30641640cba14eab8e6766094fd201da",
"operationUrl":"https://api.systempay.fr/api-payment/V4/Charge/Public/Authenticate/Session/30641640cba14eab8e6766094fd201da;JSESSIONID=7A4beEA2d5fdbFeA7389F3B91a7bDBaBc8DA9df5.default-hostname",
"_type":"V4/PCI/Authentication/AuthenticationSessionResponse"
}
}In the example :
answer.operationUrl: "https://api.systempay.fr/api-payment/V4/Charge/Public/Authenticate/Session/30641640cba14eab8e6766094fd201da;JSESSIONID=7A4beEA2d5fdbFeA7389F3B91a7bDBaBc8DA9df5.default-hostname"Transmettez le champ
operationUrlà la méthode d'authentificationkr-authenticate.jsde la librairie JS (plus d'infos : Guide d'intégration (mode simple)).
2. Redirection to the cardholder's bank's ACS.
- The JS library performs automatically all the necessary actions, without any specific development for the merchant.
3. Answer of the payment gateway server with the final authentication result (3DS Method).
{
"webService":"PCI/Authentication/CreateSession",
"version":"V4",
"applicationVersion":"5.23.0",
"serverDate":"2023-05-05T09:33:32+00:00",
"ticket":"3b68064f80f346919828dee761bd22b5",
"applicationProvider":"",
"metadata":null,
"status":"SUCCESS",
"mode":"TEST",
"serverUrl":"https://static.systempay.fr",
"_type":"V4/WebService/Response",
"answer":{
{
"id":"18e1a1a0-92f1-4722-b60b-80ec4a1f78d3",
"operationSessionId":null,
"protocol":{
"name":"THREEDS",
"version":"2.1.0",
"network":"VISA",
"challengePreference":"NO_PREFERENCE",
"simulation":true,
"_type":"V4/Charge/Authenticate/Protocol"
},
"value":{
"authenticationType":"CHALLENGE",
"authenticationId":{
"authenticationIdType":"dsTransId",
"value":"86cabade-96bb-4cc0-921b-6df6e5bd608f",
"_type":"V4/Charge/Authenticate/AuthenticationId"
},
"authenticationValue":{
"authenticationValueType":"CAVV",
"value":"ccvGMhCneJLVi5BlqDOgDtdbvSM=",
"_type":"V4/Charge/Authenticate/AuthenticationValue"
},
"status":"SUCCESS",
"commerceIndicator":"05",
"extension":{
"authenticationType":"THREEDS_V2",
"challengeCancelationIndicator":null,
"cbScore":null,
"cbAvalgo":null,
"cbExemption":null,
"paymentUseCase":null,
"threeDSServerTransID":"18e1a1a0-92f1-4722-b60b-80ec4a1f78d3",
"dsTransID":"86cabade-96bb-4cc0-921b-6df6e5bd608f",
"acsTransID":"0bd22c3e-582f-430a-a9d0-8e99fb54b9b4",
"sdkTransID":null,
"transStatusReason":null,
"requestedExemption":null,
"requestorName":"Lyra SMS",
"cardHolderInfo":null,
"dataOnlyStatus":null,
"dataOnlyDecision":null,
"dataOnlyScore":null,
"_type":"V4/Charge/Authenticate/AuthenticationResultExtensionThreedsV2"
},
"reason":{
"code":null,
"message":null,
"_type":"V4/Charge/Authenticate/AuthenticationResultReason"
},
"_type":"V4/Charge/Authenticate/AuthenticationResult"
},
"_type":"V4/AuthenticationResponseData"
}
}