3DS2 - Authentication Challenge, without 3DS Method (deprecated)
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/CreatePayment service with a card enrolled in 3DS2.
{
"amount": "9990",
"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"
}
}2. Return with instruction ,FINGERPRINT, (,3DS Method,) and session identifier ( operationSessionId,).
{
"webService":"PCI/Charge/CreatePayment",
"version":"V4",
"applicationVersion":"5.31.0",
"serverDate":"2021-11-30T13:14:26+00:00",
"ticket":"fc33bc2945c64961b5e4c26fbb388b73",
"applicationProvider":"",
"metadata":null,
"status":"SUCCESS",
"mode":"TEST",
"serverUrl":"https://api.systempay.fr",
"_type":"V4/WebService/Response",
"answer":{
"id":"dd5d2c0d-c584-4c25-87ef-07afc863b17b",
"operationSessionId":"42b8e81040aa41c79ba4c1bcafb91bda",
"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":"eyJ0aHJlZURTTWV0aG9kTm90aWZpY2F0aW9uVVJMIjoiaHR0cHM6Ly9wYXNzLWludGUwMS5seXJhLWxhYnMuZnIvcHVibGljL3YxLzNkc3YyL25vdGlmeS8zZHNtZXRob2Q_and0PUg0c0lBQUFBQUFBQUFDMVF5WTZyTUJEOG9qd1JJTnNSd21hR0pSQ3dNWmVJSGN3NklReVlyMzlFeWFGVjZxcHVWVmRuVkNkaG9ETVJDZ2ZNS2t4NEIwZlFpS0tfdF9JWUtXdXFRaG93UXdDdllBU2RlMGl1bTE1Xy0xWVpRX3FlMXoyVC1Dem9tSDhaMVdjY1dLdkRMbVdFbU1xdTlGTncxWl9CdHJmVjZpb20zWERjdVBYTnBacS1ELTlMQWpveEFXUklRSDI0Qlh2eDd2cWg0dGZRZGhpWWdPcXR1eC05ZFdzTE9SU3ZZbTBnYzI5THpzdFNUV3JkR2Q1aVlXdDRBb2RSU0d3SnI1aklIRzdteWxEbUt0N1EzZ3JXamVmQUQ1ZC1PYlBpRjRPSUg1XzI2ME9FN1U3OUFxcTVpclk4Z1BTVkx5dWVUOS01SWZfLWctbmgxWllBWjBzMWEyM1pOV2szUTRCU2FfUk92MTNyVXliWEh2RXBjQXR3dkhHbGJEOWVreVo2X2VMdFdxWV9IU08zdnhWOE9fN3k0ZzRHck1uRnFNNmNXNXBwamRmRXBEU2RZNm0xYzkycUhDOGZCTWxWS1lXTFdTczVaaVNPNDFDYTFRX3JfQm9Qc2hwcGZtWlNZQnR0WndTbnc1Uk8xUjJCSVR5NHdDSmlrYi1JenlkZ0hvZVlUM3FTQWtTQ25QOXI5RzVJcmVrS3l1VlNDalBFdVN0R0hCWnplbUxPU1h2VU1yQWI4Yk5NTXM5NFRlNDVHV1R2VXBlTU8xOS1WV0Vuc2NkS19UdURad2lkZkJhckdwdXp3bWRockViVE9pazZVZ1Z0UkRfSURKMEZvazduQmY4ODBtZVhMbExSUElwOWNvNTJOMzB0aXBhZ2VlaGZpcW5LaVpma3o1Xy0ydm1PVXl4ZVBfOEhrUzhtMTZJQ0FBQSIsInRocmVlRFNTZXJ2ZXJUcmFuc0lEIjoiZGQ1ZDJjMGQtYzU4NC00YzI1LTg3ZWYtMDdhZmM4NjNiMTdiIn0"
},
"_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":"eyJjZXJ0aWZpY2F0ZSI6IlBBU1NfbWFzdGVyX0pXVCIsInR5cCI6IkpXVCIsImFsZyI6IlJTMjU2In0.eyJwYXNzQ2xhaW0iOiJ7XCJwcm90b2NvbFwiOntcIm5hbWVcIjpcIlRIUkVFRFNcIixcInZlcnNpb25cIjpcIjIuMS4wXCIsXCJuZXR3b3JrXCI6XCJWSVNBXCIsXCJjaGFsbGVuZ2VQcmVmZXJlbmNlXCI6XCJOT19QUkVGRVJFTkNFXCIsXCJzaW11bGF0aW9uXCI6dHJ1ZX0sXCJmaW5nZXJwcmludENvbXBsZXRpb25cIjpcIlNVQ0NFU1NGVUxcIixcImV2ZW50c1wiOlt7XCJjb2RlXCI6XCIzZHNfbWV0aG9kX2RvbmVcIixcImRhdGVcIjpcIjIwMjEtMTEtMzBUMTM6MTQ6MjguMDU3MzIyWlwiLFwibGV2ZWxcIjpcIklORk9cIixcIm5ldHdvcmtcIjpcIlZJU0FcIn1dLFwiaWRcIjpcImRkNWQyYzBkLWM1ODQtNGMyNS04N2VmLTA3YWZjODYzYjE3YlwifSIsImlzcyI6IlBBU1MiLCJleHAiOjE2MzgyNzg5Njh9.WCwTvPOv2MCmldkC0E0F_5xvU3D_TvbShWh3GKx58lkMmSY_dDPBp7mCL4fktTAjGL0uDhZ7PpyHBcKx4DNRacv17pgHtZqE7n01lRfN-v1iN373dZiKOrZrNvytaQ1sKzLlf1hP7MntgrwKTg44stWocRrwHHBG4N-W7eYFEFo-iC-s_K1S8HIzfQ1WmjKh9kSnDwxRVFnk65ixCKfoYZzyGZVFLKuji67BfYQ0Cs3HEVFWE-8FXcHdZWCQDsu8fXDeWPLsO2mITwhYQSdDFdP53qGRaTqx4RIPL4by7qS8dk1kuWoJpJGjyif6Fwk_0ept38RQ29vUjHxLLQ355A",
"protocol":{
"name":"THREEDS",
"version":"2.1.0",
"network":"VISA",
"challengePreference":"NO_PREFERENCE",
"simulation":true
}
}
}5. New call to the PCI/Charge/CreatePayment service passing the instruction result and the session ID operationSessionId.
{
"operationSessionId": "42b8e81040aa41c79ba4c1bcafb91bda",
"instructionResult": {
"name" : "FINGERPRINT",
"protocol" : {
"name" : "THREEDS",
"network": "VISA",
"version" : "2.1.0",
"challengePreference": "NO_PREFERENCE",
"simulation": 1
},
"value": "eyJjZXJ0aWZpY2F0ZSI6IlBBU1NfbWFzdGVyX0pXVCIsInR5cCI6IkpXVCIsImFsZyI6IlJTMjU2In0.eyJwYXNzQ2xhaW0iOiJ7XCJwcm90b2NvbFwiOntcIm5hbWVcIjpcIlRIUkVFRFNcIixcInZlcnNpb25cIjpcIjIuMS4wXCIsXCJuZXR3b3JrXCI6XCJWSVNBXCIsXCJjaGFsbGVuZ2VQcmVmZXJlbmNlXCI6XCJOT19QUkVGRVJFTkNFXCIsXCJzaW11bGF0aW9uXCI6dHJ1ZX0sXCJmaW5nZXJwcmludENvbXBsZXRpb25cIjpcIlNVQ0NFU1NGVUxcIixcImV2ZW50c1wiOlt7XCJjb2RlXCI6XCIzZHNfbWV0aG9kX2RvbmVcIixcImRhdGVcIjpcIjIwMjEtMTEtMzBUMTM6MTQ6MjguMDU3MzIyWlwiLFwibGV2ZWxcIjpcIklORk9cIixcIm5ldHdvcmtcIjpcIlZJU0FcIn1dLFwiaWRcIjpcImRkNWQyYzBkLWM1ODQtNGMyNS04N2VmLTA3YWZjODYzYjE3YlwifSIsImlzcyI6IlBBU1MiLCJleHAiOjE2MzgyNzg5Njh9.WCwTvPOv2MCmldkC0E0F_5xvU3D_TvbShWh3GKx58lkMmSY_dDPBp7mCL4fktTAjGL0uDhZ7PpyHBcKx4DNRacv17pgHtZqE7n01lRfN-v1iN373dZiKOrZrNvytaQ1sKzLlf1hP7MntgrwKTg44stWocRrwHHBG4N-W7eYFEFo-iC-s_K1S8HIzfQ1WmjKh9kSnDwxRVFnk65ixCKfoYZzyGZVFLKuji67BfYQ0Cs3HEVFWE-8FXcHdZWCQDsu8fXDeWPLsO2mITwhYQSdDFdP53qGRaTqx4RIPL4by7qS8dk1kuWoJpJGjyif6Fwk_0ept38RQ29vUjHxLLQ355A"
}
}7. A return with a CHALLENGE instruction of redirection to the ACS with a CReq (visible iFrame).
{
"webService":"PCI/Charge/CreatePayment",
"version":"V4",
"applicationVersion":"5.31.0",
"serverDate":"2021-11-30T13:14:28+00:00",
"ticket":"b5ed24e51d6e4b6bb2c38074bf538ed2",
"applicationProvider":"",
"metadata":null,
"status":"SUCCESS",
"mode":"TEST",
"serverUrl":"https://api.systempay.fr",
"_type":"V4/WebService/Response",
"answer":{
"id":"dd5d2c0d-c584-4c25-87ef-07afc863b17b",
"operationSessionId":"42b8e81040aa41c79ba4c1bcafb91bda",
"protocol":{
"name":"THREEDS",
"version":"2.1.0",
"network":"VISA",
"challengePreference":"NO_PREFERENCE",
"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":"eyJ0aHJlZURTU2VydmVyVHJhbnNJRCI6ImRkNWQyYzBkLWM1ODQtNGMyNS04N2VmLTA3YWZjODYzYjE3YiIsIm1lc3NhZ2VFeHRlbnNpb24iOlt7ImNyaXRpY2FsaXR5SW5kaWNhdG9yIjpmYWxzZSwiZGF0YSI6eyJ0aHJlZURTU2VydmVyVHJhbnNJRCI6ImRkNWQyYzBkLWM1ODQtNGMyNS04N2VmLTA3YWZjODYzYjE3YiIsIm1lc3NhZ2VUeXBlIjoiQVJlcSIsIm1lc3NhZ2VWZXJzaW9uIjoiMi4xLjAiLCJkZXZpY2VDaGFubmVsIjoiMDIiLCJ0aHJlZURTU2VydmVyUmVmTnVtYmVyIjoiM0RTX0xPQV9TRVJfTFlORV8wMjAxMDBfMDAwOTgiLCJ0aHJlZURTU2VydmVyT3BlcmF0b3JJRCI6ImJhdG1hbkVuU2xpcCIsInRocmVlRFNDb21wSW5kIjoiWSIsInRocmVlRFNSZXF1ZXN0b3JBdXRoZW50aWNhdGlvbkluZCI6IjAxIiwidGhyZWVEU1JlcXVlc3RvckNoYWxsZW5nZUluZCI6IjAxIiwidGhyZWVEU1JlcXVlc3RvcklEIjoiVEVTVCIsInRocmVlRFNSZXF1ZXN0b3JOYW1lIjoiTHlyYSBTTVMiLCJ0aHJlZURTUmVxdWVzdG9yVVJMIjoiaHR0cDovL3d3dy5seXJhLXNtcy5jb20iLCJ0aHJlZURTU2VydmVyVVJMIjoiaHR0cDovL2xvY2FsaG9zdDo4MDgwL3Byb3RlY3RlZC92MS8zZHN2Mi9ub3RpZnkvcnJlcT9uZXR3b3JrPVZJU0EmbWVzc2FnZVZlcnNpb249Mi4xLjAmZGV2aWNlQ2hhbm5lbD1CUk9XU0VSJmNoYWxsZW5nZUluZD1OT19QUkVGRVJFTkNFJmF1dGhlbnRpY2F0ZUlkPWRkNWQyYzBkLWM1ODQtNGMyNS04N2VmLTA3YWZjODYzYjE3YiIsImFjcXVpcmVyQklOIjoiNDk3NTc4IiwiYWNxdWlyZXJNZXJjaGFudElEIjoiMDQ1MjUxNzg1NzAwMDI4IiwiYWRkck1hdGNoIjoiWSIsImJyb3dzZXJBY2NlcHRIZWFkZXIiOiJ0ZXh0L2h0bWwsYXBwbGljYXRpb24veGh0bWwreG1sLGFwcGxpY2F0aW9uL3htbDtxPTAuOSxpbWFnZS9hdmlmLGltYWdlL3dlYnAsaW1hZ2UvYXBuZywqLyo7cT0wLjgsYXBwbGljYXRpb24vc2lnbmVkLWV4Y2hhbmdlO3Y9YjM7cT0wLjkiLCJicm93c2VySVAiOiIxMC4zMy4xMTcuNDIiLCJicm93c2VySmF2YUVuYWJsZWQiOnRydWUsImJyb3dzZXJMYW5ndWFnZSI6ImZyLUZSIiwiYnJvd3NlckNvbG9yRGVwdGgiOiIyNCIsImJyb3dzZXJTY3JlZW5IZWlnaHQiOiI3MjAiLCJicm93c2VyU2NyZWVuV2lkdGgiOiIxMjgwIiwiYnJvd3NlclRaIjoiLTYwIiwiYnJvd3NlclVzZXJBZ2VudCI6Ik1vemlsbGEvNS4wIChXaW5kb3dzIE5UIDEwLjA7IFdpbjY0OyB4NjQpIEFwcGxlV2ViS2l0LzUzNy4zNiAoS0hUTUwsIGxpa2UgR2Vja28pIENocm9tZS85Ni4wLjQ2NjQuNDUgU2FmYXJpLzUzNy4zNiIsImNhcmRFeHBpcnlEYXRlIjoiMjMxMSIsImFjY3RJbmZvIjp7InNoaXBOYW1lSW5kaWNhdG9yIjoiMDEifSwiYWNjdE51bWJlciI6IjQ5NzAxMTAwMDAwMDEwMDMiLCJlbWFpbCI6InNhbXBsZUBleGFtcGxlLmNvbSIsIm1jYyI6IjU5NjUiLCJtZXJjaGFudENvdW50cnlDb2RlIjoiMjUwIiwibWVyY2hhbnROYW1lIjoiTHlyYSBTTVMiLCJtZXNzYWdlQ2F0ZWdvcnkiOiIwMSIsIm5vdGlmaWNhdGlvblVSTCI6Imh0dHBzOi8vcGFzcy1pbnRlMDEubHlyYS1sYWJzLmZyL3B1YmxpYy92MS8zZHN2Mi9ub3RpZnkvY3Jlcy9kZDVkMmMwZC1jNTg0LTRjMjUtODdlZi0wN2FmYzg2M2IxN2IvVklTQSIsInB1cmNoYXNlQW1vdW50IjoiOTk5MCIsInB1cmNoYXNlQ3VycmVuY3kiOiI5NzgiLCJwdXJjaGFzZUV4cG9uZW50IjoiMiIsInB1cmNoYXNlRGF0ZSI6IjIwMjExMTMwMTMxNDI4IiwidHJhbnNUeXBlIjoiMDEifSwiaWQiOiJTSU1VTEFUSU9OLUFSRVEiLCJuYW1lIjoiU0lNVUxBVElPTi1BUkVRIn1dLCJtZXNzYWdlVHlwZSI6IkNSZXEiLCJtZXNzYWdlVmVyc2lvbiI6IjIuMS4wIiwiYWNzVHJhbnNJRCI6IjRhN2EyYWZhLTg0YjktNDcxMy1iMzY0LTUzY2QwMGM3YjkzYyIsImNoYWxsZW5nZVdpbmRvd1NpemUiOiIwMyJ9",
"threeDSSessionData":"H4sIAAAAAAAAAC1Qx46rQBD8on0awBh8JDOYOEO-IJtgssEYE77-Ye0eWqWu6lZ1db5pdRxq4BbEQ0TKIMbwDFue9wizuAfynin-FoIh9AU4wR7RqXDozV_fyVO8fec116g9EvbgX75pSxSau0Ou5S0AlVVpTChor_DYO2pHsrEdOB3c_uUyVSNivKaw51NYDylsaDskeIy8WPYa33KAn8Lqq6NfvUONGThbtPONHhiEJTpvUzE2E4OTSfqd7nJUFMS1JUZ7VEtU1C6VLi_V_UDrKL9pXcf_5bI_zqhOq17zvz7dn0_NHXdqF1gt1e3IA-tn5Umy623f3P7p-wfDjXZLhJQlNqSlgn94XncsGiHTduqwkg4HE5abWlZPxnbK006x3_5VslULmWMg-IbtlCOXXTr2Q6tsN6AWGYT9IWu5EKdzUp6eKFcoCZfdIj_FoAhnBafz8AH7Sf-Z3jZNJrQW3s5JgRp7xPYWqdf3vCWAopNFodLi_lBBOSoQU0zwGLK2c68GWptiIoUM1A6VBOOs095TRK90KkHP-ac8bir60QNiI9MgYuQo1yP68SpdJuRYPBYXzy4-80b28xq3Nj9LTV5iRY_kZyr-BJmfsF6IWHrQpKuEtUBLlj7fnezeE-Ay-o2dCVjf15zGkS0mTCNmz594tO7n1x5cZZuhOYNBhDy9hPgtaeLLqd7cf8G9Op6iAgAA"
},
"_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":"eyJjZXJ0aWZpY2F0ZSI6IlBBU1NfbWFzdGVyX0pXVCIsInR5cCI6IkpXVCIsImFsZyI6IlJTMjU2In0.eyJwYXNzQ2xhaW0iOiJ7XCJwcm90b2NvbFwiOntcIm5hbWVcIjpcIlRIUkVFRFNcIixcInZlcnNpb25cIjpcIjIuMS4wXCIsXCJuZXR3b3JrXCI6XCJWSVNBXCIsXCJjaGFsbGVuZ2VQcmVmZXJlbmNlXCI6XCJOT19QUkVGRVJFTkNFXCIsXCJzaW11bGF0aW9uXCI6dHJ1ZX0sXCJhdXRoZW50aWNhdGlvblJlc3VsdFwiOntcInJlc3BvbnNlVHlwZVwiOlwiUkVTVUxUXCIsXCJ0eXBlXCI6XCJDSEFMTEVOR0VcIixcImF1dGhlbnRpY2F0aW9uSWRcIjp7XCJ0eXBlXCI6XCJkc1RyYW5zSWRcIixcInZhbHVlXCI6XCIzNmY4Mzg5Yi0yYzc3LTRkNjMtYjRmMy1hMjdmNDc4NGQyNTFcIn0sXCJhdXRoZW50aWNhdGlvblZhbHVlXCI6e1widHlwZVwiOlwiQ0FWVlwiLFwidmFsdWVcIjpcIjNMZkJ4R3plWFB4RGNmWlNaL2I0cjR6S291WT1cIn0sXCJzdGF0dXNcIjpcIlNVQ0NFU1NcIixcImNvbW1lcmNlSW5kaWNhdG9yXCI6XCIwNVwiLFwiZXh0ZW5zaW9uXCI6e1widHlwZVwiOlwiVEhSRUVEU19WMlwiLFwidGhyZWVEU1NlcnZlclRyYW5zSURcIjpcImRkNWQyYzBkLWM1ODQtNGMyNS04N2VmLTA3YWZjODYzYjE3YlwiLFwiZHNUcmFuc0lEXCI6XCIzNmY4Mzg5Yi0yYzc3LTRkNjMtYjRmMy1hMjdmNDc4NGQyNTFcIixcImFjc1RyYW5zSURcIjpcIjZkYWE1NzYwLWZiNDgtNDNiYi04ZTY3LTQzMGJlYjAyNzhiY1wifSxcInJlYXNvblwiOnt9fSxcImV2ZW50c1wiOltdLFwiaWRcIjpcImRkNWQyYzBkLWM1ODQtNGMyNS04N2VmLTA3YWZjODYzYjE3YlwiLFwic2Vzc2lvbkRhdGFcIjp7XCJrXCI6XCIzRFMyXCIsXCJzXCI6dHJ1ZSxcInBcIjpcIk5PX1BSRUZFUkVOQ0VcIixcInRcIjpcImRkNWQyYzBkLWM1ODQtNGMyNS04N2VmLTA3YWZjODYzYjE3YlwiLFwiblwiOlwiVklTQVwiLFwidlwiOlwiMi4xLjBcIixcImRcIjpcIjAyXCJ9fSIsImlzcyI6IlBBU1MiLCJleHAiOjE2MzgyNzkwMDB9.LyCpZHsOx_j_xd1M9SqACfyG9tpueM0jiD1Qh8nNEiVhZRnZP_jugYZQ4Yk2T43mEjs3MNtLZL-_yKg8vx4naYhkrw1BpBeWuut8jrPupBDk4dJf0uy7ro6PiYre49JHLJH5J8KREOCWMaAwHa5Szp6DmDza6p7iaJ4g_U3LhWfQcvEcsgHghLMR6qwjL7vpDa3gr1S-rZEa6dmjanm6NWQTzOyBC9esswd6nc0eOHjO8EwSwJxlYYPcFpR6aa0oN95Tt_n2Qxxd39j2lVrf2Tlq5YYotAtldSLt5Oget3SDgfa7HhYMbPggwMyf0Je9gKzLk2aUPxtI52pMpGc7YA",
"protocol":{
"name":"THREEDS",
"version":"2.1.0",
"network":"VISA",
"challengePreference":"NO_PREFERENCE",
"simulation":true
}
}
}9. New call to the PCI/Charge/CreatePayment service passing the instruction result and the operationSessionId session identifier.
{
"operationSessionId": "42b8e81040aa41c79ba4c1bcafb91bda",
"instructionResult": {
"name" : "CHALLENGE",
"protocol" : {
"name" : "THREEDS",
"network": "VISA",
"version" : "2.1.0",
"challengePreference": "NO_PREFERENCE",
"simulation": 1
},
"value": "eyJjZXJ0aWZpY2F0ZSI6IlBBU1NfbWFzdGVyX0pXVCIsInR5cCI6IkpXVCIsImFsZyI6IlJTMjU2In0.eyJwYXNzQ2xhaW0iOiJ7XCJwcm90b2NvbFwiOntcIm5hbWVcIjpcIlRIUkVFRFNcIixcInZlcnNpb25cIjpcIjIuMS4wXCIsXCJuZXR3b3JrXCI6XCJWSVNBXCIsXCJjaGFsbGVuZ2VQcmVmZXJlbmNlXCI6XCJOT19QUkVGRVJFTkNFXCIsXCJzaW11bGF0aW9uXCI6dHJ1ZX0sXCJhdXRoZW50aWNhdGlvblJlc3VsdFwiOntcInJlc3BvbnNlVHlwZVwiOlwiUkVTVUxUXCIsXCJ0eXBlXCI6XCJDSEFMTEVOR0VcIixcImF1dGhlbnRpY2F0aW9uSWRcIjp7XCJ0eXBlXCI6XCJkc1RyYW5zSWRcIixcInZhbHVlXCI6XCIzNmY4Mzg5Yi0yYzc3LTRkNjMtYjRmMy1hMjdmNDc4NGQyNTFcIn0sXCJhdXRoZW50aWNhdGlvblZhbHVlXCI6e1widHlwZVwiOlwiQ0FWVlwiLFwidmFsdWVcIjpcIjNMZkJ4R3plWFB4RGNmWlNaL2I0cjR6S291WT1cIn0sXCJzdGF0dXNcIjpcIlNVQ0NFU1NcIixcImNvbW1lcmNlSW5kaWNhdG9yXCI6XCIwNVwiLFwiZXh0ZW5zaW9uXCI6e1widHlwZVwiOlwiVEhSRUVEU19WMlwiLFwidGhyZWVEU1NlcnZlclRyYW5zSURcIjpcImRkNWQyYzBkLWM1ODQtNGMyNS04N2VmLTA3YWZjODYzYjE3YlwiLFwiZHNUcmFuc0lEXCI6XCIzNmY4Mzg5Yi0yYzc3LTRkNjMtYjRmMy1hMjdmNDc4NGQyNTFcIixcImFjc1RyYW5zSURcIjpcIjZkYWE1NzYwLWZiNDgtNDNiYi04ZTY3LTQzMGJlYjAyNzhiY1wifSxcInJlYXNvblwiOnt9fSxcImV2ZW50c1wiOltdLFwiaWRcIjpcImRkNWQyYzBkLWM1ODQtNGMyNS04N2VmLTA3YWZjODYzYjE3YlwiLFwic2Vzc2lvbkRhdGFcIjp7XCJrXCI6XCIzRFMyXCIsXCJzXCI6dHJ1ZSxcInBcIjpcIk5PX1BSRUZFUkVOQ0VcIixcInRcIjpcImRkNWQyYzBkLWM1ODQtNGMyNS04N2VmLTA3YWZjODYzYjE3YlwiLFwiblwiOlwiVklTQVwiLFwidlwiOlwiMi4xLjBcIixcImRcIjpcIjAyXCJ9fSIsImlzcyI6IlBBU1MiLCJleHAiOjE2MzgyNzkwMDB9.LyCpZHsOx_j_xd1M9SqACfyG9tpueM0jiD1Qh8nNEiVhZRnZP_jugYZQ4Yk2T43mEjs3MNtLZL-_yKg8vx4naYhkrw1BpBeWuut8jrPupBDk4dJf0uy7ro6PiYre49JHLJH5J8KREOCWMaAwHa5Szp6DmDza6p7iaJ4g_U3LhWfQcvEcsgHghLMR6qwjL7vpDa3gr1S-rZEa6dmjanm6NWQTzOyBC9esswd6nc0eOHjO8EwSwJxlYYPcFpR6aa0oN95Tt_n2Qxxd39j2lVrf2Tlq5YYotAtldSLt5Oget3SDgfa7HhYMbPggwMyf0Je9gKzLk2aUPxtI52pMpGc7YA"
}
}10. Return from the payment platform server with the payment result.
Successful authentication.
{
"webService":"PCI/Charge/CreatePayment",
"version":"V4",
"applicationVersion":"5.31.0",
"status":"SUCCESS",
"answer":{
"shopId":"12345678",
"orderCycle":"CLOSED",
"orderStatus":"PAID",
"serverDate":"2021-11-30T13:15:01+00:00",
"orderDetails":{
"orderTotalAmount":9990,
"orderEffectiveAmount":9990,
"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":null,
"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":"10.33.117.42",
"browserUserAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/96.0.4664.45 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":"97eb58160a124fe1ba350a3686d46a3c",
"amount":9990,
"currency":"EUR",
"paymentMethodType":"CARD",
"paymentMethodToken":null,
"status":"PAID",
"detailedStatus":"AUTHORISED",
"operationType":"DEBIT",
"effectiveStrongAuthentication":"ENABLED",
"creationDate":"2021-11-30T13:15:00+00:00",
"errorCode":null,
"errorMessage":null,
"detailedErrorCode":null,
"detailedErrorMessage":null,
"metadata":null,
"transactionDetails":{
"liabilityShift":"YES",
"effectiveAmount":9990,
"effectiveCurrency":"EUR",
"creationContext":"CHARGE",
"cardDetails":{
"paymentSource":"EC",
"manualValidation":"NO",
"expectedCaptureDate":"2021-11-30T13:14:25+00:00",
"effectiveBrand":"VISA",
"pan":"497011XXXXXX1003",
"expiryMonth":11,
"expiryYear":2027,
"country":"FR",
"issuerCode":17807,
"issuerName":"BP Occitane",
"effectiveProductCode":null,
"legacyTransId":"938884",
"legacyTransDate":"2021-11-30T13:15:00+00:00",
"paymentMethodSource":"NEW",
"authorizationResponse":{
"amount":9990,
"currency":"EUR",
"authorizationDate":"2021-11-30T13:15:00+00:00",
"authorizationNumber":"3fefd1",
"authorizationResult":"0",
"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":"dd5d2c0d-c584-4c25-87ef-07afc863b17b",
"operationSessionId":"42b8e81040aa41c79ba4c1bcafb91bda",
"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":"36f8389b-2c77-4d63-b4f3-a27f4784d251",
"_type":"V4/Charge/Authenticate/AuthenticationId"
},
"authenticationValue":{
"authenticationValueType":"CAVV",
"value":"3**************************=",
"_type":"V4/Charge/Authenticate/AuthenticationValue"
},
"status":"SUCCESS",
"commerceIndicator":"05",
"extension":{
"authenticationType":"THREEDS_V2",
"threeDSServerTransID":"dd5d2c0d-c584-4c25-87ef-07afc863b17b",
"dsTransID":"36f8389b-2c77-4d63-b4f3-a27f4784d251",
"acsTransID":"6daa5760-fb48-43bb-8e67-430beb0278bc",
"_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":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":[
{
"name":"CARD_FRAUD",
"result":"OK",
"_type":"V4/PaymentMethod/Details/Risk/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":"012",
"acquirerNetwork":"CB",
"taxRefundAmount":null,
"userInfo":null,
"paymentMethodTokenPreviouslyRegistered":null,
"occurrenceType":"UNITAIRE",
"_type":"V4/TransactionDetails"
},
"_type":"V4/PaymentTransaction"
}
],
"subMerchantDetails":null,
"_type":"V4/Payment"
},
"ticket":"2fa70f3f6cd942c186ca21e87c3eb522",
"serverDate":"2021-11-30T13:15:01+00:00",
"applicationProvider":"",
"metadata":null,
"mode":"TEST",
"serverUrl":"https://api.systempay.fr",
"_type":"V4/WebService/Response"
}Failed authentication
{
"webService":"PCI/Charge/CreatePayment",
"version":"V4",
"applicationVersion":"5.31.0",
"status":"SUCCESS",
"answer":{
"shopId":"12345678",
"orderCycle":"CLOSED",
"orderStatus":"UNPAID",
"serverDate":"2021-11-30T13:49:16+00:00",
"orderDetails":{
"orderTotalAmount":9990,
"orderEffectiveAmount":9990,
"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":null,
"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":"10.33.117.42",
"browserUserAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/96.0.4664.45 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":"4f4be14ca43b40e3bb5a8d7ea309955e",
"amount":9990,
"currency":"EUR",
"paymentMethodType":"CARD",
"paymentMethodToken":null,
"status":"UNPAID",
"detailedStatus":"REFUSED",
"operationType":"DEBIT",
"effectiveStrongAuthentication":"DISABLED",
"creationDate":"2021-11-30T13:49: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":9990,
"effectiveCurrency":"EUR",
"creationContext":"CHARGE",
"cardDetails":{
"paymentSource":"EC",
"manualValidation":"NO",
"expectedCaptureDate":"2021-11-30T13:49:04+00:00",
"effectiveBrand":"VISA",
"pan":"497011XXXXXX1003",
"expiryMonth":11,
"expiryYear":2027,
"country":"FR",
"issuerCode":17807,
"issuerName":"BP Occitane",
"effectiveProductCode":null,
"legacyTransId":"947080",
"legacyTransDate":"2021-11-30T13:49:15+00:00",
"paymentMethodSource":"NEW",
"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":"f5e0bf10-7c73-4ab8-8fbb-39b73bcf2949",
"operationSessionId":"90bb0dbdd6cf4c30b81094f97fb8ff13",
"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":"789d9783-9a57-46e1-a8a7-f724e300b05c",
"_type":"V4/Charge/Authenticate/AuthenticationId"
},
"status":"FAILED",
"extension":{
"authenticationType":"THREEDS_V2",
"threeDSServerTransID":"f5e0bf10-7c73-4ab8-8fbb-39b73bcf2949",
"dsTransID":"789d9783-9a57-46e1-a8a7-f724e300b05c",
"acsTransID":"d5f8a0a6-a9af-4053-ad21-fb83e7444506",
"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":[
{
"name":"CARD_FRAUD",
"result":"OK",
"_type":"V4/PaymentMethod/Details/Risk/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":"012",
"acquirerNetwork":"CB",
"taxRefundAmount":null,
"userInfo":null,
"paymentMethodTokenPreviouslyRegistered":null,
"occurrenceType":"UNITAIRE",
"_type":"V4/TransactionDetails"
},
"_type":"V4/PaymentTransaction"
}
],
"subMerchantDetails":null,
"_type":"V4/Payment"
},
"ticket":"af49c6ef883d4a2992afcfc575b17af6",
"serverDate":"2021-11-30T13:49:16+00:00",
"applicationProvider":"",
"metadata":null,
"mode":"TEST",
"serverUrl":"https://api.systempay.fr",
"_type":"V4/WebService/Response"
}