• France
état des services
démonstrations
assistance
FAQContacter le support
Tutoriels vidéo
Rechercher
Catégories
Tags
Français
Français
Anglais
Accueil
Cas d'usage
Créer un paiement
Créer un paiement en plusieurs fois
Proposer un paiement complémentaire
Créer un paiement par alias (token)
Créer un lien de paiement
Créer un abonnement
Gérer vos abonnements
Gérer vos transactions (rembourser,...)
Analyser vos journaux
Docs API
Formulaire embarqué
API REST
Formulaire en redirection
Intégration mobile
Échange de fichiers
Exemples de code
Moyens de paiement
Modules de paiement
Guides
Back Office Marchand
Guides fonctionnels

3DS2 - Authentification Challenge, avec 3DS Method

Pour tester ce scénario, utilisez un des numéros de carte ci-dessous :

Carte Date de validité Marque
4970110000001003 Au choix VISA
5100010000000106 Au choix MASTERCARD
375900000010015 Au choix AMEX

Cinématique des échanges

  1. Appel initial au service PCI/Charge/CreateToken avec une carte enrôlée 3DS2.

    {
      "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. Retour avec une instruction FINGERPRINT (3DS Method) et l'identifiant de session (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":"https://api-sogecommerce.societegenerale.eu",
        "_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 vers l’ACS dans l’iFrame invisible, chargement et exécution du code JavaScript de fingerprint de l’ACS.

    Les caractéristiques de l'iFrame sont données dans l'objet answer.value.target.

    Le formulaire à afficher dans l'iFrame est décrit dans l'objet answer.value.http.


  4. Retour via le navigateur avec un résultat d’instruction.

    {
    	"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. Nouvel appel au service PCI/Charge/CreateToken en transmettant le résultat d'instruction et l'identifant de session 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"
      }    
    }
  6. Retour avec une instruction CHALLENGE de redirection vers l’ACS avec un Creq (iFrame visible).

    {
        "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":"https://api-sogecommerce.societegenerale.eu",
        "_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 vers l’ACS dans l’iFrame pour l'authentification du porteur.

    Les caractéristiques de l'iFrame sont données dans l'objet answer.value.target.

    Le formulaire à afficher dans l'iFrame est décrit dans l'objet answer.value.http.


  8. Retour via le navigateur avec un résultat d’instruction.

    {
    	"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. Nouvel appel au service PCI/Charge/CreateToken en transmettant le résultat d'instruction et l'identifant de session operationSessionId.

    {
      "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. Retour du serveur de la plateforme de paiement avec le résultat final.
    Authentification réussie

    {
        "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":"https://api-sogecommerce.societegenerale.eu",
        "_type":"V4/WebService/Response"
    }
    Authentification en échec

    {
        "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":"https://api-sogecommerce.societegenerale.eu",
        "_type":"V4/WebService/Response"
    }
© 2025 Tous droits réservés à Sogecommerce
25.22-1.11