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. Initial call to the PCI/Charge/CreateToken service with a 3DS2 enrolled card.
{
"currency": "EUR",
"paymentForms": [
{
"paymentMethodType": "CARD",
"pan": "4970110000001003",
"expiryMonth": "11",
"expiryYear": "27",
"securityCode": "123"
}
],
"device": {
"acceptHeader":"text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.9",
"colorDepth":"24",
"deviceType":"BROWSER",
"ip":"69.89.31.226",
"javaEnabled":false,
"language":"fr-FR",
"screenHeight":"720",
"screenWidth":"1280",
"timeZoneOffset":"-60",
"userAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/96.0.4664.45 Safari/537.36"
},
"customer": {
"email": "sample@example.com",
"reference":"myCustomerRef-123456"
}
}2. Return with a FINGERPRINT (3DS Method) instruction and the session ID (operationSessionId).
{
"webService":"PCI/Charge/CreateToken",
"version":"V4",
"applicationVersion":"5.30.0",
"serverDate":"2021-12-10T09:13:20+00:00",
"ticket":"b75c77d153ad411d873229baa752a8db",
"applicationProvider":"",
"metadata":null,
"status":"SUCCESS",
"mode":"TEST",
"serverUrl":"",
"_type":"V4/WebService/Response",
"answer":{
"id":"ef93067b-7f34-4310-b472-12130d057d0c",
"operationSessionId":"4076a3360e264455876b997a47ff4871",
"protocol":{
"name":"THREEDS",
"version":"2.1.0",
"network":"VISA",
"challengePreference":"NO_PREFERENCE",
"simulation":true,
"_type":"V4/Charge/Authenticate/Protocol"
},
"value":{
"instructionType":"FORM",
"name":"FINGERPRINT",
"timeout":10,
"target":{
"element":"IFRAME",
"visible":false,
"_type":"V4/Charge/Authenticate/InstructionTarget",
"showUrl":true,
"fullscreen":false
},
"http":{
"method":"POST",
"url":"https://acs-test.com/acs/v2/3dsMethod",
"body":{
"threeDSMethodData":"eyJ0aHJlZURTTWV0aG9kTm90aWZpY2F0aW9uVVJMIjoiaHR0cHM6Ly90bHMtcGFzcy5wYXl6ZW4uZXUvcHVibGljL3YxLzNkc3YyL25vdGlmeS8zZHNtZXRob2Q_and0PUg0c0lBQUFBQUFBQUFDMVIyNUtDTUF6OUluWUtDLW8tY3BFRnBDQ1VTLTBMdzBXd0lGcFgxMEtfZm5IY2gwd201eVJ6Y3BMajdQVUVlNkRNQ1Rzb05pRElYYmxudzBqbG9JVklGY0dzY2d3WXprejM3bDVpclRZWGZ2aXZSX3RPNWxlX2w4QS1WZHdMLURqT0hqX2dRRVRLZENwelFFUHFyYkhwX2VCbGJna1IyM0JlOG4zQnhBdHJIRThtYUtyZGkxRzdQYXZkUWR0ajJVQnhTdXgweU1JSVpMVkxYM3o4NXNkc0RCUElnNzZoZnRLTVVFU1B3SUlUTkdVYVdQWHNKOXNaTGp5eGREbFFJbjZRT2ZWdFRxc3pwLUVTMlhCT291eU5OZjhZcE9yazk4WmJaX3pYNmZWbFQtX0xwWnlXaXgtM3Y5SjBheWZwX1BLZHFhODd3T1Fnd2tVdnRGSU9IZkFSb29PR3pGYkpRWkZEdFVNckJyUnVIY01qRi12Q3h6SC10Slc4TXF5Zmcyb2dlQ0pxSzVLQ0VER1piSVRuaktMa1ZvMjgzWnRzYm9aN181dFQtRm1CUUpMcUR1d0t4WExBVHF1MEtyX3I1Qmk1ZzR6a0NSa05ISUtkbmtkNUY5OUU3RHZXcXJ4ZXZxYjFKWkZMTU43a21HRTFYOWZhQmNtRXFfVnRWcVM5QUJHZHYzdFZhbjJBN0djZ1R1SHFuUHVibHE5aWhhWGU1bEZBY3JPdW51RXRyYzd5czYwdVBfMWh3MHBGMF9mRU9rbnR5dGVsc1RjTHJnRlNiWnJ5LTNrc1dXVHctYmxwazBfWV9XQmtNS3cxRXhvVVMxS2l0cFIzRER0blZ5TVAxbldLd3lQemQ5Z1hqMzNqXzJaRXE3WjFkajNaRUZhMHJadXNVZk1vdlZHUjZIOXM2b0dvb2dJQUFBIiwidGhyZWVEU1NlcnZlclRyYW5zSUQiOiJlZjkzMDY3Yi03ZjM0LTQzMTAtYjQ3Mi0xMjEzMGQwNTdkMGMifQ"
},
"_type":"V4/Charge/Authenticate/HttpRequest"
},
"_type":"V4/Charge/Authenticate/AuthenticationInstruction"
},
"_type":"V4/AuthenticationResponseData"
}
}3. Redirection to the ACS in the invisible iFrame, loading and execution of the JavaScript code of the ACS fingerprint.
The iFrame characteristics are provided in the answer.value.target object.
The form to be displayed in the iFrame is described in the answer.value.http object.
4. Return via the browser with an instruction result.
{
"eventName":"LYRA_AUTH_INSTRUCTION_RESULT",
"value":{
"name":"FINGERPRINT",
"value":"eyJjZXJ0aWZpY2F0ZSI6IlBBU1NfMS4zNy4wX0pXVCIsInR5cCI6IkpXVCIsImFsZyI6IlJTMjU2In0.eyJwYXNzQ2xhaW0iOiJ7XCJwcm90b2NvbFwiOntcIm5hbWVcIjpcIlRIUkVFRFNcIixcInZlcnNpb25cIjpcIjIuMS4wXCIsXCJuZXR3b3JrXCI6XCJWSVNBXCIsXCJjaGFsbGVuZ2VQcmVmZXJlbmNlXCI6XCJOT19QUkVGRVJFTkNFXCIsXCJzaW11bGF0aW9uXCI6dHJ1ZX0sXCJmaW5nZXJwcmludENvbXBsZXRpb25cIjpcIlNVQ0NFU1NGVUxcIixcImV2ZW50c1wiOlt7XCJjb2RlXCI6XCIzZHNfbWV0aG9kX2RvbmVcIixcImRhdGVcIjpcIjIwMjEtMTItMTBUMDk6MTM6MzIuOTc4NjkxWlwiLFwibGV2ZWxcIjpcIklORk9cIixcIm5ldHdvcmtcIjpcIlZJU0FcIn1dLFwiaWRcIjpcImVmOTMwNjdiLTdmMzQtNDMxMC1iNDcyLTEyMTMwZDA1N2QwY1wifSIsImlzcyI6IlBBU1MiLCJleHAiOjE2MzkxMjg1MTJ9.UBU104tGyQXjIQybXT5708HFcyuwrDakuM81YX0zPxMMtmf8gbX7T5Obg1TCOFfNrqzLc2jTxrUsd1E-St2Mf1Tm4REWqWRByHilSLzuhzh-cW1mWOavJKKPLD5OCkMgWQ7yRNREu2sI3urDAXybKtZBUmsGBpyFWTdS4DxztR2tkRznlnjdGJPkwku3uKXaM8sW7ErDei02dKVp1icYNbbO7FpdILCJ5Fa-HL4dgmNzGgsKtdfxkEVGx-YKc-81jkk1E80IC0sEpWqRVuUSZKuITnDDpEVvSFC1BLTFkJ1SQV5VFyp0g9p8tNx2yC37BU9vcf8bjJV0TbX0v_svtw",
"protocol":{
"name":"THREEDS",
"version":"2.1.0",
"network":"VISA",
"challengePreference":"NO_PREFERENCE",
"simulation":true
}
}
}5. New call to the PCI/Charge/CreateToken service passing the instruction result and the session ID (operationSessionId).
{
"operationSessionId": "4076a3360e264455876b997a47ff4871",
"instructionResult": {
"name" : "FINGERPRINT",
"protocol" : {
"name" : "THREEDS",
"network": "VISA",
"version" : "2.1.0",
"challengePreference": "NO_PREFERENCE",
"simulation": 1
},
"value": "eyJjZXJ0aWZpY2F0ZSI6IlBBU1NfMS4zNy4wX0pXVCIsInR5cCI6IkpXVCIsImFsZyI6IlJTMjU2In0.eyJwYXNzQ2xhaW0iOiJ7XCJwcm90b2NvbFwiOntcIm5hbWVcIjpcIlRIUkVFRFNcIixcInZlcnNpb25cIjpcIjIuMS4wXCIsXCJuZXR3b3JrXCI6XCJWSVNBXCIsXCJjaGFsbGVuZ2VQcmVmZXJlbmNlXCI6XCJOT19QUkVGRVJFTkNFXCIsXCJzaW11bGF0aW9uXCI6dHJ1ZX0sXCJmaW5nZXJwcmludENvbXBsZXRpb25cIjpcIlNVQ0NFU1NGVUxcIixcImV2ZW50c1wiOlt7XCJjb2RlXCI6XCIzZHNfbWV0aG9kX2RvbmVcIixcImRhdGVcIjpcIjIwMjEtMTItMTBUMDk6MTM6MzIuOTc4NjkxWlwiLFwibGV2ZWxcIjpcIklORk9cIixcIm5ldHdvcmtcIjpcIlZJU0FcIn1dLFwiaWRcIjpcImVmOTMwNjdiLTdmMzQtNDMxMC1iNDcyLTEyMTMwZDA1N2QwY1wifSIsImlzcyI6IlBBU1MiLCJleHAiOjE2MzkxMjg1MTJ9.UBU104tGyQXjIQybXT5708HFcyuwrDakuM81YX0zPxMMtmf8gbX7T5Obg1TCOFfNrqzLc2jTxrUsd1E-St2Mf1Tm4REWqWRByHilSLzuhzh-cW1mWOavJKKPLD5OCkMgWQ7yRNREu2sI3urDAXybKtZBUmsGBpyFWTdS4DxztR2tkRznlnjdGJPkwku3uKXaM8sW7ErDei02dKVp1icYNbbO7FpdILCJ5Fa-HL4dgmNzGgsKtdfxkEVGx-YKc-81jkk1E80IC0sEpWqRVuUSZKuITnDDpEVvSFC1BLTFkJ1SQV5VFyp0g9p8tNx2yC37BU9vcf8bjJV0TbX0v_svtw"
}
}2. A return with a CHALLENGE instruction of redirection to the ACS with a CReq (visible iFrame).
{
"webService":"PCI/Charge/CreateToken",
"version":"V4",
"applicationVersion":"5.30.0",
"serverDate":"2021-12-10T09:13:33+00:00",
"ticket":"2f56558fa5ee4b27a70ff03a45f6776b",
"applicationProvider":"",
"metadata":null,
"status":"SUCCESS",
"mode":"TEST",
"serverUrl":"",
"_type":"V4/WebService/Response",
"answer":{
"id":"ef93067b-7f34-4310-b472-12130d057d0c",
"operationSessionId":"4076a3360e264455876b997a47ff4871",
"protocol":{
"name":"THREEDS",
"version":"2.1.0",
"network":"VISA",
"challengePreference":"CHALLENGE_MANDATED",
"simulation":true,
"_type":"V4/Charge/Authenticate/Protocol"
},
"value":{
"instructionType":"FORM",
"name":"CHALLENGE",
"timeout":600,
"target":{
"element":"IFRAME",
"visible":true,
"width":500,
"height":600,
"_type":"V4/Charge/Authenticate/InstructionTarget",
"showUrl":true,
"fullscreen":false
},
"http":{
"method":"POST",
"url":"https://acs-test.com/acs/v2/creq",
"body":{
"creq":"eyJ0aHJlZURTU2VydmVyVHJhbnNJRCI6ImVmOTMwNjdiLTdmMzQtNDMxMC1iNDcyLTEyMTMwZDA1N2QwYyIsIm1lc3NhZ2VFeHRlbnNpb24iOlt7ImNyaXRpY2FsaXR5SW5kaWNhdG9yIjpmYWxzZSwiZGF0YSI6eyJ0aHJlZURTU2VydmVyVHJhbnNJRCI6ImVmOTMwNjdiLTdmMzQtNDMxMC1iNDcyLTEyMTMwZDA1N2QwYyIsIm1lc3NhZ2VUeXBlIjoiQVJlcSIsIm1lc3NhZ2VWZXJzaW9uIjoiMi4xLjAiLCJkZXZpY2VDaGFubmVsIjoiMDIiLCJ0aHJlZURTU2VydmVyUmVmTnVtYmVyIjoiM0RTX0xPQV9TRVJfTFlORV8wMjAxMDBfMDAzNjkiLCJ0aHJlZURTU2VydmVyT3BlcmF0b3JJRCI6IjEwMDY5NzMyIiwidGhyZWVEU0NvbXBJbmQiOiJZIiwidGhyZWVEU1JlcXVlc3RvckF1dGhlbnRpY2F0aW9uSW5kIjoiMDQiLCJ0aHJlZURTUmVxdWVzdG9yQ2hhbGxlbmdlSW5kIjoiMDQiLCJ0aHJlZURTUmVxdWVzdG9ySUQiOiIxMDA3MTUyOSoxOTk5ODg4IiwidGhyZWVEU1JlcXVlc3Rvck5hbWUiOiJERU1PIFN0b3JlIiwidGhyZWVEU1JlcXVlc3RvclVSTCI6Imh0dHA6Ly9kZW1vLmx5cmEtbmV0d29yay5jb20iLCJ0aHJlZURTU2VydmVyVVJMIjoiaHR0cDovL2xvY2FsaG9zdDo4MDgwL3Byb3RlY3RlZC92MS8zZHN2Mi9ub3RpZnkvcnJlcT9uZXR3b3JrPVZJU0EmbWVzc2FnZVZlcnNpb249Mi4xLjAmZGV2aWNlQ2hhbm5lbD1CUk9XU0VSJmNoYWxsZW5nZUluZD1DSEFMTEVOR0VfTUFOREFURUQmYXV0aGVudGljYXRlSWQ9ZWY5MzA2N2ItN2YzNC00MzEwLWI0NzItMTIxMzBkMDU3ZDBjIiwiYWNxdWlyZXJCSU4iOiI0OTc1NjYiLCJhY3F1aXJlck1lcmNoYW50SUQiOiIxOTk5ODg4IiwiYWRkck1hdGNoIjoiWSIsImJyb3dzZXJBY2NlcHRIZWFkZXIiOiJ0ZXh0L2h0bWwsYXBwbGljYXRpb24veGh0bWwreG1sLGFwcGxpY2F0aW9uL3htbDtxPTAuOSxpbWFnZS9hdmlmLGltYWdlL3dlYnAsaW1hZ2UvYXBuZywqLyo7cT0wLjgsYXBwbGljYXRpb24vc2lnbmVkLWV4Y2hhbmdlO3Y9YjM7cT0wLjkiLCJicm93c2VySVAiOiIxODUuMjQ0LjczLjIiLCJicm93c2VySmF2YUVuYWJsZWQiOnRydWUsImJyb3dzZXJMYW5ndWFnZSI6ImZyLUZSIiwiYnJvd3NlckNvbG9yRGVwdGgiOiIyNCIsImJyb3dzZXJTY3JlZW5IZWlnaHQiOiI3MjAiLCJicm93c2VyU2NyZWVuV2lkdGgiOiIxMjgwIiwiYnJvd3NlclRaIjoiLTYwIiwiYnJvd3NlclVzZXJBZ2VudCI6Ik1vemlsbGEvNS4wIChXaW5kb3dzIE5UIDEwLjA7IFdpbjY0OyB4NjQpIEFwcGxlV2ViS2l0LzUzNy4zNiAoS0hUTUwsIGxpa2UgR2Vja28pIENocm9tZS85Ni4wLjQ2NjQuOTMgU2FmYXJpLzUzNy4zNiIsImNhcmRFeHBpcnlEYXRlIjoiMjcxMSIsImFjY3RJbmZvIjp7InNoaXBOYW1lSW5kaWNhdG9yIjoiMDEifSwiYWNjdE51bWJlciI6IjQ5NzAxMTAwMDAwMDEwMDMiLCJlbWFpbCI6InNhbXBsZUBleGFtcGxlLmNvbSIsIm1jYyI6IjQyMjUiLCJtZXJjaGFudENvdW50cnlDb2RlIjoiMjUwIiwibWVyY2hhbnROYW1lIjoiREVNTyBTdG9yZSIsIm1lc3NhZ2VDYXRlZ29yeSI6IjAxIiwibm90aWZpY2F0aW9uVVJMIjoiaHR0cHM6Ly90bHMtcGFzcy5wYXl6ZW4uZXUvcHVibGljL3YxLzNkc3YyL25vdGlmeS9jcmVzL2VmOTMwNjdiLTdmMzQtNDMxMC1iNDcyLTEyMTMwZDA1N2QwYy9WSVNBIiwicHVyY2hhc2VBbW91bnQiOiIwIiwicHVyY2hhc2VDdXJyZW5jeSI6Ijk3OCIsInB1cmNoYXNlRXhwb25lbnQiOiIyIiwicHVyY2hhc2VEYXRlIjoiMjAyMTEyMTAwOTEzMzMiLCJ0cmFuc1R5cGUiOiIwMSJ9LCJpZCI6IlNJTVVMQVRJT04tQVJFUSIsIm5hbWUiOiJTSU1VTEFUSU9OLUFSRVEifV0sIm1lc3NhZ2VUeXBlIjoiQ1JlcSIsIm1lc3NhZ2VWZXJzaW9uIjoiMi4xLjAiLCJhY3NUcmFuc0lEIjoiYjJiMDI0NjEtZWI4My00NDRlLThkODgtMmI1NTZiNWQ5MGVhIiwiY2hhbGxlbmdlV2luZG93U2l6ZSI6IjAzIn0",
"threeDSSessionData":"H4sIAAAAAAAAAC2P25KqMBBFv4ipAILyCEg0kQTBAJEXiwEvwIh4wUC-_mAdH3Z19e7uWruPI64zjkGeZt1egyDbIRP9OU6s0hPZzSQdZ4KDjicueqI2Mgp3mjff_gqf2fjZx4zUsYZa8HMcsdhzKkNtuOQpqIIKz7mLH3y6myQjSMapPidPfrxyjdVsNxSodQpUdwVqKArjgUSxsY4Si4ax4YVJBCMoKn9SOSn4E1WW7g0ibY1q6EW1vaQuAER6wk8RoBK9CEMDkU5DlrGeLZ36y-z_58DpLqHO19O-2Ua_9nry5WRfDlniKRuofBd3hU4-_4RhQhmqph1-Eai-DbQmxsSbUebJU_gTKMNZr-WNkfbNnrLQ1TeTHMYv9f0e82NZLTLcmnG3Od5xUHpwdbavA7vPVmA99vBsFLppR1hoJyO-HLpD-rBPbcdPXpCvYLkJKVaii_Xybf3v-lQeF33Lmo5d66i8edAtGssEeu1sb1og-akCs-5MG3RY8CAyg5Dl_vy-SDU16X4tszXO_XopDXXri1R6j1_CDTcTgzGPYAsr1R49PT-K9MbumtNhabP63bvuQZG3ztiFe63Ptmcex_ah3szvUn1KbAeECS5bhdpyqbwKMe8bm0TJ_IUECGYQZkdlyNPVJr0KBLRA2TMRrYRilUGP3666slobSKxc1MBrFnVuWsEAr2Aj_gEUKEyfqQIAAA"
},
"_type":"V4/Charge/Authenticate/HttpRequest"
},
"_type":"V4/Charge/Authenticate/AuthenticationInstruction"
},
"_type":"V4/AuthenticationResponseData"
}
}7. Redirection to the ACS in the iFrame for cardholder authentication.
The iFrame characteristics are provided in the answer.value.target object.
The form to be displayed in the iFrame is described in the answer.value.http object.
8. Return via the browser with an instruction result.
{
"eventName":"LYRA_AUTH_INSTRUCTION_RESULT",
"value":{
"name":"CHALLENGE",
"value":"eyJjZXJ0aWZpY2F0ZSI6IlBBU1NfMS4zNy4wX0pXVCIsInR5cCI6IkpXVCIsImFsZyI6IlJTMjU2In0.eyJwYXNzQ2xhaW0iOiJ7XCJwcm90b2NvbFwiOntcIm5hbWVcIjpcIlRIUkVFRFNcIixcInZlcnNpb25cIjpcIjIuMS4wXCIsXCJuZXR3b3JrXCI6XCJWSVNBXCIsXCJjaGFsbGVuZ2VQcmVmZXJlbmNlXCI6XCJDSEFMTEVOR0VfTUFOREFURURcIixcInNpbXVsYXRpb25cIjp0cnVlfSxcImF1dGhlbnRpY2F0aW9uUmVzdWx0XCI6e1wicmVzcG9uc2VUeXBlXCI6XCJSRVNVTFRcIixcInR5cGVcIjpcIkNIQUxMRU5HRVwiLFwiYXV0aGVudGljYXRpb25JZFwiOntcInR5cGVcIjpcImRzVHJhbnNJZFwiLFwidmFsdWVcIjpcImUwZDBkNmJhLTM4NjAtNDc2MC1iMWRiLTk3ZDJmNWRjMThjZFwifSxcImF1dGhlbnRpY2F0aW9uVmFsdWVcIjp7XCJ0eXBlXCI6XCJDQVZWXCIsXCJ2YWx1ZVwiOlwiSlp4QTJleHBFNlAvTU9DR2xmT0RnQUoyYVUwPVwifSxcInN0YXR1c1wiOlwiU1VDQ0VTU1wiLFwiY29tbWVyY2VJbmRpY2F0b3JcIjpcIjA1XCIsXCJleHRlbnNpb25cIjp7XCJ0eXBlXCI6XCJUSFJFRURTX1YyXCIsXCJ0aHJlZURTU2VydmVyVHJhbnNJRFwiOlwiZWY5MzA2N2ItN2YzNC00MzEwLWI0NzItMTIxMzBkMDU3ZDBjXCIsXCJkc1RyYW5zSURcIjpcImUwZDBkNmJhLTM4NjAtNDc2MC1iMWRiLTk3ZDJmNWRjMThjZFwiLFwiYWNzVHJhbnNJRFwiOlwiOGQ2NjIwOWQtZjc5Yy00Y2VkLTkzNGUtYzUzZGZmNTBjZDljXCJ9LFwicmVhc29uXCI6e319LFwiZXZlbnRzXCI6W10sXCJpZFwiOlwiZWY5MzA2N2ItN2YzNC00MzEwLWI0NzItMTIxMzBkMDU3ZDBjXCIsXCJzZXNzaW9uRGF0YVwiOntcImtcIjpcIjNEUzJcIixcInNcIjp0cnVlLFwicFwiOlwiQ0hBTExFTkdFX01BTkRBVEVEXCIsXCJ0XCI6XCJlZjkzMDY3Yi03ZjM0LTQzMTAtYjQ3Mi0xMjEzMGQwNTdkMGNcIixcIm5cIjpcIlZJU0FcIixcInZcIjpcIjIuMS4wXCIsXCJkXCI6XCIwMlwifX0iLCJpc3MiOiJQQVNTIiwiZXhwIjoxNjM5MTI4NTc1fQ.YeHH9zKqkY0Z5M4S-8MaVa_Gac-Iex9crdYeCj5SlCLwG39HXh1FRvK3dVIyppUbCOFhpHbk1iyXFbzlvQ2_PP-VJX9asYnz96XvtDmmQ73LZMKqos5g3LkIJwRNEM7FgxAlBN3ZdnFj4zDI9Iya8T2SC3K1au2SET3nqxtL5SbQR6SDfu6ed0grBbpAa5zKjDfLDe4aAQeD-PzX-GpW9WixZ4gzaePAvRziwIkIQHYimQ0ZBCLrCOVBceZbLJ9G7F3DU-pyX1yUZwR5ttJgHH-kUzk_9R0-dZ1VUlGZ5561JSRXFPlNKmKdLZTzNe2SmvQm4-c11ikRUfKw-v3syA",
"protocol":{
"name":"THREEDS",
"version":"2.1.0",
"network":"VISA",
"challengePreference":"CHALLENGE_MANDATED",
"simulation":true
}
}
}9. New call to the PCI/Charge/CreateToken service passing the instruction result and the operationSessionId session identifier.
{
"operationSessionId": "4076a3360e264455876b997a47ff4871",
"instructionResult": {
"name" : "CHALLENGE",
"protocol" : {
"name" : "THREEDS",
"network": "VISA",
"version" : "2.1.0",
"challengePreference": "CHALLENGE_MANDATED",
"simulation": 1
},
"value": "eyJjZXJ0aWZpY2F0ZSI6IlBBU1NfMS4zNy4wX0pXVCIsInR5cCI6IkpXVCIsImFsZyI6IlJTMjU2In0.eyJwYXNzQ2xhaW0iOiJ7XCJwcm90b2NvbFwiOntcIm5hbWVcIjpcIlRIUkVFRFNcIixcInZlcnNpb25cIjpcIjIuMS4wXCIsXCJuZXR3b3JrXCI6XCJWSVNBXCIsXCJjaGFsbGVuZ2VQcmVmZXJlbmNlXCI6XCJDSEFMTEVOR0VfTUFOREFURURcIixcInNpbXVsYXRpb25cIjp0cnVlfSxcImF1dGhlbnRpY2F0aW9uUmVzdWx0XCI6e1wicmVzcG9uc2VUeXBlXCI6XCJSRVNVTFRcIixcInR5cGVcIjpcIkNIQUxMRU5HRVwiLFwiYXV0aGVudGljYXRpb25JZFwiOntcInR5cGVcIjpcImRzVHJhbnNJZFwiLFwidmFsdWVcIjpcImUwZDBkNmJhLTM4NjAtNDc2MC1iMWRiLTk3ZDJmNWRjMThjZFwifSxcImF1dGhlbnRpY2F0aW9uVmFsdWVcIjp7XCJ0eXBlXCI6XCJDQVZWXCIsXCJ2YWx1ZVwiOlwiSlp4QTJleHBFNlAvTU9DR2xmT0RnQUoyYVUwPVwifSxcInN0YXR1c1wiOlwiU1VDQ0VTU1wiLFwiY29tbWVyY2VJbmRpY2F0b3JcIjpcIjA1XCIsXCJleHRlbnNpb25cIjp7XCJ0eXBlXCI6XCJUSFJFRURTX1YyXCIsXCJ0aHJlZURTU2VydmVyVHJhbnNJRFwiOlwiZWY5MzA2N2ItN2YzNC00MzEwLWI0NzItMTIxMzBkMDU3ZDBjXCIsXCJkc1RyYW5zSURcIjpcImUwZDBkNmJhLTM4NjAtNDc2MC1iMWRiLTk3ZDJmNWRjMThjZFwiLFwiYWNzVHJhbnNJRFwiOlwiOGQ2NjIwOWQtZjc5Yy00Y2VkLTkzNGUtYzUzZGZmNTBjZDljXCJ9LFwicmVhc29uXCI6e319LFwiZXZlbnRzXCI6W10sXCJpZFwiOlwiZWY5MzA2N2ItN2YzNC00MzEwLWI0NzItMTIxMzBkMDU3ZDBjXCIsXCJzZXNzaW9uRGF0YVwiOntcImtcIjpcIjNEUzJcIixcInNcIjp0cnVlLFwicFwiOlwiQ0hBTExFTkdFX01BTkRBVEVEXCIsXCJ0XCI6XCJlZjkzMDY3Yi03ZjM0LTQzMTAtYjQ3Mi0xMjEzMGQwNTdkMGNcIixcIm5cIjpcIlZJU0FcIixcInZcIjpcIjIuMS4wXCIsXCJkXCI6XCIwMlwifX0iLCJpc3MiOiJQQVNTIiwiZXhwIjoxNjM5MTI4NTc1fQ.YeHH9zKqkY0Z5M4S-8MaVa_Gac-Iex9crdYeCj5SlCLwG39HXh1FRvK3dVIyppUbCOFhpHbk1iyXFbzlvQ2_PP-VJX9asYnz96XvtDmmQ73LZMKqos5g3LkIJwRNEM7FgxAlBN3ZdnFj4zDI9Iya8T2SC3K1au2SET3nqxtL5SbQR6SDfu6ed0grBbpAa5zKjDfLDe4aAQeD-PzX-GpW9WixZ4gzaePAvRziwIkIQHYimQ0ZBCLrCOVBceZbLJ9G7F3DU-pyX1yUZwR5ttJgHH-kUzk_9R0-dZ1VUlGZ5561JSRXFPlNKmKdLZTzNe2SmvQm4-c11ikRUfKw-v3syA"
}
}10. Return from the payment platform server with the final result.
Successful authentication.
{
"webService":"PCI/Charge/CreateToken",
"version":"V4",
"applicationVersion":"5.30.0",
"status":"SUCCESS",
"answer":{
"shopId":"12345678",
"orderCycle":"CLOSED",
"orderStatus":"PAID",
"serverDate":"2021-12-10T09:14:38+00:00",
"orderDetails":{
"orderTotalAmount":0,
"orderEffectiveAmount":0,
"orderCurrency":"EUR",
"mode":"TEST",
"orderId":null,
"metadata":null,
"_type":"V4/OrderDetails"
},
"customer":{
"billingDetails":{
"address":null,
"category":null,
"cellPhoneNumber":null,
"city":null,
"country":null,
"district":null,
"firstName":null,
"identityCode":null,
"language":"FR",
"lastName":null,
"phoneNumber":null,
"state":null,
"streetNumber":null,
"title":null,
"zipCode":null,
"legalName":null,
"_type":"V4/Customer/BillingDetails"
},
"email":"sample@example.com",
"reference":"myCustomerRef-123456",
"shippingDetails":{
"address":null,
"address2":null,
"category":null,
"city":null,
"country":null,
"deliveryCompanyName":null,
"district":null,
"firstName":null,
"identityCode":null,
"lastName":null,
"legalName":null,
"phoneNumber":null,
"shippingMethod":null,
"shippingSpeed":null,
"state":null,
"streetNumber":null,
"zipCode":null,
"_type":"V4/Customer/ShippingDetails"
},
"extraDetails":{
"browserAccept":null,
"fingerPrintId":null,
"ipAddress":"185.244.73.2",
"browserUserAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/96.0.4664.93 Safari/537.36",
"_type":"V4/Customer/ExtraDetails"
},
"shoppingCart":{
"insuranceAmount":null,
"shippingAmount":null,
"taxAmount":null,
"cartItemInfo":null,
"_type":"V4/Customer/ShoppingCart"
},
"_type":"V4/Customer/Customer"
},
"transactions":[
{
"shopId":"12345678",
"uuid":"d35bb16041114ee0b063ebcb0a6c0e2d",
"amount":0,
"currency":"EUR",
"paymentMethodType":"CARD",
"paymentMethodToken":"4ea4a56e5e3f480a9206bbe6fad1be25",
"status":"PAID",
"detailedStatus":"ACCEPTED",
"operationType":"VERIFICATION",
"effectiveStrongAuthentication":"ENABLED",
"creationDate":"2021-12-10T09:14:35+00:00",
"errorCode":null,
"errorMessage":null,
"detailedErrorCode":null,
"detailedErrorMessage":null,
"metadata":null,
"transactionDetails":{
"liabilityShift":"NO",
"effectiveAmount":0,
"effectiveCurrency":"EUR",
"creationContext":"VERIFICATION",
"cardDetails":{
"paymentSource":"EC",
"manualValidation":"NO",
"expectedCaptureDate":null,
"effectiveBrand":"VISA",
"pan":"497011XXXXXX1003",
"expiryMonth":11,
"expiryYear":2027,
"country":"FR",
"issuerCode":17807,
"issuerName":"Banque Populaire Occitane",
"effectiveProductCode":null,
"legacyTransId":"935357",
"legacyTransDate":"2021-12-10T09:14:35+00:00",
"paymentMethodSource":"TOKEN",
"authorizationResponse":{
"amount":null,
"currency":null,
"authorizationDate":null,
"authorizationNumber":null,
"authorizationResult":null,
"authorizationMode":"MARK",
"_type":"V4/PaymentMethod/Details/Cards/CardAuthorizationResponse"
},
"captureResponse":{
"refundAmount":null,
"refundCurrency":null,
"captureDate":null,
"captureFileNumber":null,
"effectiveRefundAmount":null,
"effectiveRefundCurrency":null,
"_type":"V4/PaymentMethod/Details/Cards/CardCaptureResponse"
},
"threeDSResponse":{
"authenticationResultData":{
"transactionCondition":null,
"enrolled":null,
"status":null,
"eci":null,
"xid":null,
"cavvAlgorithm":null,
"cavv":null,
"signValid":null,
"brand":null,
"_type":"V4/PaymentMethod/Details/Cards/CardAuthenticationResponse"
},
"_type":"V4/PaymentMethod/Details/Cards/ThreeDSResponse"
},
"authenticationResponse":{
"id":"ef93067b-7f34-4310-b472-12130d057d0c",
"operationSessionId":"4076a3360e264455876b997a47ff4871",
"protocol":{
"name":"THREEDS",
"version":"2.1.0",
"network":"VISA",
"challengePreference":"CHALLENGE_MANDATED",
"simulation":true,
"_type":"V4/Charge/Authenticate/Protocol"
},
"value":{
"authenticationType":"CHALLENGE",
"authenticationId":{
"authenticationIdType":"dsTransId",
"value":"e0d0d6ba-3860-4760-b1db-97d2f5dc18cd",
"_type":"V4/Charge/Authenticate/AuthenticationId"
},
"authenticationValue":{
"authenticationValueType":"CAVV",
"value":"J**************************=",
"_type":"V4/Charge/Authenticate/AuthenticationValue"
},
"status":"SUCCESS",
"commerceIndicator":"05",
"extension":{
"authenticationType":"THREEDS_V2",
"threeDSServerTransID":"ef93067b-7f34-4310-b472-12130d057d0c",
"dsTransID":"e0d0d6ba-3860-4760-b1db-97d2f5dc18cd",
"acsTransID":"8d66209d-f79c-4ced-934e-c53dff50cd9c",
"_type":"V4/Charge/Authenticate/AuthenticationResultExtensionThreedsV2"
},
"reason":{
"_type":"V4/Charge/Authenticate/AuthenticationResultReason"
},
"_type":"V4/Charge/Authenticate/AuthenticationResult"
},
"_type":"V4/AuthenticationResponseData"
},
"installmentNumber":null,
"installmentCode":null,
"markAuthorizationResponse":{
"amount":0,
"currency":"EUR",
"authorizationDate":"2021-12-10T09:14:35+00:00",
"authorizationNumber":"3fb85c",
"authorizationResult":"0",
"_type":"V4/PaymentMethod/Details/Cards/MarkAuthorizationResponse"
},
"cardHolderName":null,
"identityDocumentNumber":null,
"identityDocumentType":null,
"_type":"V4/PaymentMethod/Details/CardDetails"
},
"fraudManagement":{
"riskControl":[],
"riskAnalysis":[],
"_type":"V4/PaymentMethod/Details/FraudManagement"
},
"subscriptionDetails":{
"subscriptionId":null,
"_type":"V4/PaymentMethod/Details/SubscriptionDetails"
},
"parentTransactionUuid":null,
"mid":"9999999",
"sequenceNumber":1,
"taxAmount":null,
"preTaxAmount":null,
"taxRate":null,
"externalTransactionId":null,
"nsu":null,
"tid":"001",
"acquirerNetwork":"CB",
"taxRefundAmount":null,
"userInfo":"API REST",
"paymentMethodTokenPreviouslyRegistered":null,
"occurrenceType":"RECURRENT_INITIAL",
"_type":"V4/TransactionDetails"
},
"_type":"V4/PaymentTransaction"
}
],
"subMerchantDetails":null,
"_type":"V4/Payment"
},
"ticket":"89f0ea5a615243d9969ebeb21457a2fc",
"serverDate":"2021-12-10T09:14:38+00:00",
"applicationProvider":"",
"metadata":null,
"mode":"TEST",
"serverUrl":"",
"_type":"V4/WebService/Response"
}Failed authentication
{
"webService":"PCI/Charge/CreateToken",
"version":"V4",
"applicationVersion":"5.30.0",
"status":"SUCCESS",
"answer":{
"shopId":"12345678",
"orderCycle":"CLOSED",
"orderStatus":"UNPAID",
"serverDate":"2021-12-10T09:16:17+00:00",
"orderDetails":{
"orderTotalAmount":0,
"orderEffectiveAmount":0,
"orderCurrency":"EUR",
"mode":"TEST",
"orderId":null,
"metadata":null,
"_type":"V4/OrderDetails"
},
"customer":{
"billingDetails":{
"address":null,
"category":null,
"cellPhoneNumber":null,
"city":null,
"country":null,
"district":null,
"firstName":null,
"identityCode":null,
"language":"FR",
"lastName":null,
"phoneNumber":null,
"state":null,
"streetNumber":null,
"title":null,
"zipCode":null,
"legalName":null,
"_type":"V4/Customer/BillingDetails"
},
"email":"sample@example.com",
"reference":"myCustomerRef-123456",
"shippingDetails":{
"address":null,
"address2":null,
"category":null,
"city":null,
"country":null,
"deliveryCompanyName":null,
"district":null,
"firstName":null,
"identityCode":null,
"lastName":null,
"legalName":null,
"phoneNumber":null,
"shippingMethod":null,
"shippingSpeed":null,
"state":null,
"streetNumber":null,
"zipCode":null,
"_type":"V4/Customer/ShippingDetails"
},
"extraDetails":{
"browserAccept":null,
"fingerPrintId":null,
"ipAddress":"185.244.73.2",
"browserUserAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/96.0.4664.93 Safari/537.36",
"_type":"V4/Customer/ExtraDetails"
},
"shoppingCart":{
"insuranceAmount":null,
"shippingAmount":null,
"taxAmount":null,
"cartItemInfo":null,
"_type":"V4/Customer/ShoppingCart"
},
"_type":"V4/Customer/Customer"
},
"transactions":[
{
"shopId":"12345678",
"uuid":"0f1bfd75b1bf41fb982aa55158b9cd04",
"amount":0,
"currency":"EUR",
"paymentMethodType":"CARD",
"paymentMethodToken":null,
"status":"UNPAID",
"detailedStatus":"REFUSED",
"operationType":"VERIFICATION",
"effectiveStrongAuthentication":"DISABLED",
"creationDate":"2021-12-10T09:16:15+00:00",
"errorCode":"PSP_539",
"errorMessage":"3D Secure refusal for the transaction",
"detailedErrorCode":"39",
"detailedErrorMessage":"3D Secure refusal for the transaction.",
"metadata":null,
"transactionDetails":{
"liabilityShift":null,
"effectiveAmount":0,
"effectiveCurrency":"EUR",
"creationContext":"VERIFICATION",
"cardDetails":{
"paymentSource":"EC",
"manualValidation":"NO",
"expectedCaptureDate":null,
"effectiveBrand":"VISA",
"pan":"497011XXXXXX1003",
"expiryMonth":11,
"expiryYear":2027,
"country":"FR",
"issuerCode":17807,
"issuerName":"Banque Populaire Occitane",
"effectiveProductCode":null,
"legacyTransId":"912933",
"legacyTransDate":"2021-12-10T09:16:15+00:00",
"paymentMethodSource":"TOKEN",
"authorizationResponse":{
"amount":null,
"currency":null,
"authorizationDate":null,
"authorizationNumber":null,
"authorizationResult":null,
"authorizationMode":"FULL",
"_type":"V4/PaymentMethod/Details/Cards/CardAuthorizationResponse"
},
"captureResponse":{
"refundAmount":null,
"refundCurrency":null,
"captureDate":null,
"captureFileNumber":null,
"effectiveRefundAmount":null,
"effectiveRefundCurrency":null,
"_type":"V4/PaymentMethod/Details/Cards/CardCaptureResponse"
},
"threeDSResponse":{
"authenticationResultData":{
"transactionCondition":null,
"enrolled":null,
"status":null,
"eci":null,
"xid":null,
"cavvAlgorithm":null,
"cavv":null,
"signValid":null,
"brand":null,
"_type":"V4/PaymentMethod/Details/Cards/CardAuthenticationResponse"
},
"_type":"V4/PaymentMethod/Details/Cards/ThreeDSResponse"
},
"authenticationResponse":{
"id":"ef93067b-7f34-4310-b472-12130d057d0c",
"operationSessionId":"4076a3360e264455876b997a47ff4871",
"protocol":{
"name":"THREEDS",
"version":"2.1.0",
"network":"VISA",
"challengePreference":"CHALLENGE_MANDATED",
"simulation":true,
"_type":"V4/Charge/Authenticate/Protocol"
},
"value":{
"authenticationType":"CHALLENGE",
"authenticationId":{
"authenticationIdType":"dsTransId",
"value":"e379d26b-4a81-43b8-bf98-db3f5c635094",
"_type":"V4/Charge/Authenticate/AuthenticationId"
},
"status":"FAILED",
"extension":{
"authenticationType":"THREEDS_V2",
"threeDSServerTransID":"ef93067b-7f34-4310-b472-12130d057d0c",
"dsTransID":"e379d26b-4a81-43b8-bf98-db3f5c635094",
"acsTransID":"8a0199f9-ad5b-4e08-8e6d-cad73cb92846",
"transStatusReason":"01",
"_type":"V4/Charge/Authenticate/AuthenticationResultExtensionThreedsV2"
},
"reason":{
"code":"CARD_AUTHENTICATION_FAILED",
"_type":"V4/Charge/Authenticate/AuthenticationResultReason"
},
"_type":"V4/Charge/Authenticate/AuthenticationResult"
},
"_type":"V4/AuthenticationResponseData"
},
"installmentNumber":null,
"installmentCode":null,
"markAuthorizationResponse":{
"amount":null,
"currency":null,
"authorizationDate":null,
"authorizationNumber":null,
"authorizationResult":null,
"_type":"V4/PaymentMethod/Details/Cards/MarkAuthorizationResponse"
},
"cardHolderName":null,
"identityDocumentNumber":null,
"identityDocumentType":null,
"_type":"V4/PaymentMethod/Details/CardDetails"
},
"fraudManagement":{
"riskControl":[],
"riskAnalysis":[],
"_type":"V4/PaymentMethod/Details/FraudManagement"
},
"subscriptionDetails":{
"subscriptionId":null,
"_type":"V4/PaymentMethod/Details/SubscriptionDetails"
},
"parentTransactionUuid":null,
"mid":"9999999",
"sequenceNumber":1,
"taxAmount":null,
"preTaxAmount":null,
"taxRate":null,
"externalTransactionId":null,
"nsu":null,"tid":"001",
"acquirerNetwork":"CB",
"taxRefundAmount":null,
"userInfo":"API REST",
"paymentMethodTokenPreviouslyRegistered":null,
"occurrenceType":"RECURRENT_INITIAL",
"_type":"V4/TransactionDetails"
},
"_type":"V4/PaymentTransaction"
}
],
"subMerchantDetails":null,
"_type":"V4/Payment"
},
"ticket":"ad41fcabc47f4446a5c6fae8f57ffc3f",
"serverDate":"2021-12-10T09:16:17+00:00",
"applicationProvider":"",
"metadata":null
"mode":"TEST",
"serverUrl":"",
"_type":"V4/WebService/Response"
}