• France
status page
demonstrations
assistance
FAQContact support
Search
Categories
Tags
English
French
English
Homepage
Use cases
Create a payment
Create an installment payment
Create a multi-card (split) payment
Create a payment by Alias (Token)
Create a payment link
Create a recurring payment
Manage subscriptions
Manage your transactions (refund, cancel...)
Analyze your reports
API docs
Embedded Form
REST API
Hosted payment
Mobile payment
File exchange
Snippets
Payment methods
Plugins
Guides
Merchant Back Office
Functional guides

3DS2 - Challenge authentication, without the 3DS Method

To test this scenario, use one of the card numbers below:

CARD Expiry date Label
4970110000000021 To be chosen VISA
5100010000000049 To be chosen MASTERCARD
375900000000016 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": "5100010000000049",			    
      "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. 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-09T15:25:44+00:00",
    "ticket":"c941b59112154913a311f0abfd68ccda",
    "applicationProvider":"",
    "metadata":null,
    "status":"SUCCESS",
    "mode":"TEST",
    "serverUrl":"https://api-sogecommerce.societegenerale.eu",
    "_type":"V4/WebService/Response",
    "answer":{
        "id":"35714f94-4464-489a-89db-051a88c093ae",
        "operationSessionId":"fae70e432ad14feda188873d105b0939",
        "protocol":{
            "name":"THREEDS",
            "version":"2.1.0",
            "network":"MASTERCARD",
            "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":"eyJ0aHJlZURTU2VydmVyVHJhbnNJRCI6IjM1NzE0Zjk0LTQ0NjQtNDg5YS04OWRiLTA1MWE4OGMwOTNhZSIsIm1lc3NhZ2VFeHRlbnNpb24iOlt7ImNyaXRpY2FsaXR5SW5kaWNhdG9yIjpmYWxzZSwiZGF0YSI6eyJ0aHJlZURTU2VydmVyVHJhbnNJRCI6IjM1NzE0Zjk0LTQ0NjQtNDg5YS04OWRiLTA1MWE4OGMwOTNhZSIsIm1lc3NhZ2VUeXBlIjoiQVJlcSIsIm1lc3NhZ2VWZXJzaW9uIjoiMi4xLjAiLCJkZXZpY2VDaGFubmVsIjoiMDIiLCJ0aHJlZURTU2VydmVyUmVmTnVtYmVyIjoiM0RTX0xPQV9TRVJfTFlORV8wMjAxMDBfMDAzNjkiLCJ0aHJlZURTU2VydmVyT3BlcmF0b3JJRCI6IlNWUi1WMjEwLUxZUkFfTkVUV09SSy04MTg2NyIsInRocmVlRFNDb21wSW5kIjoiVSIsInRocmVlRFNSZXF1ZXN0b3JBdXRoZW50aWNhdGlvbkluZCI6IjA0IiwidGhyZWVEU1JlcXVlc3RvckNoYWxsZW5nZUluZCI6IjA0IiwidGhyZWVEU1JlcXVlc3RvcklEIjoiTFlSNTkzNTNfMTk5OTg4OCIsInRocmVlRFNSZXF1ZXN0b3JOYW1lIjoiTHlyYSBBdXRoZW50aWNhdGlvbiBTZXJ2ZXJfREVNTyBTdG9yZSIsInRocmVlRFNSZXF1ZXN0b3JVUkwiOiJodHRwOi8vZGVtby5seXJhLW5ldHdvcmsuY29tIiwidGhyZWVEU1NlcnZlclVSTCI6Imh0dHA6Ly9sb2NhbGhvc3Q6ODA4MC9wcm90ZWN0ZWQvdjEvM2RzdjIvbm90aWZ5L3JyZXE_bmV0d29yaz1NQVNURVJDQVJEJm1lc3NhZ2VWZXJzaW9uPTIuMS4wJmRldmljZUNoYW5uZWw9QlJPV1NFUiZjaGFsbGVuZ2VJbmQ9Q0hBTExFTkdFX01BTkRBVEVEJmF1dGhlbnRpY2F0ZUlkPTM1NzE0Zjk0LTQ0NjQtNDg5YS04OWRiLTA1MWE4OGMwOTNhZSIsImFjcXVpcmVyQklOIjoiNTEzNTIzIiwiYWNxdWlyZXJNZXJjaGFudElEIjoiMTk5OTg4OCIsImFkZHJNYXRjaCI6IlkiLCJicm93c2VyQWNjZXB0SGVhZGVyIjoidGV4dC9odG1sLGFwcGxpY2F0aW9uL3hodG1sK3htbCxhcHBsaWNhdGlvbi94bWw7cT0wLjksaW1hZ2UvYXZpZixpbWFnZS93ZWJwLGltYWdlL2FwbmcsKi8qO3E9MC44LGFwcGxpY2F0aW9uL3NpZ25lZC1leGNoYW5nZTt2PWIzO3E9MC45IiwiYnJvd3NlcklQIjoiMTg1LjI0NC43My4yIiwiYnJvd3NlckphdmFFbmFibGVkIjp0cnVlLCJicm93c2VyTGFuZ3VhZ2UiOiJmci1GUiIsImJyb3dzZXJDb2xvckRlcHRoIjoiMjQiLCJicm93c2VyU2NyZWVuSGVpZ2h0IjoiNzIwIiwiYnJvd3NlclNjcmVlbldpZHRoIjoiMTI4MCIsImJyb3dzZXJUWiI6Ii02MCIsImJyb3dzZXJVc2VyQWdlbnQiOiJNb3ppbGxhLzUuMCAoV2luZG93cyBOVCAxMC4wOyBXaW42NDsgeDY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvOTYuMC40NjY0LjQ1IFNhZmFyaS81MzcuMzYiLCJjYXJkRXhwaXJ5RGF0ZSI6IjI3MTEiLCJhY2N0SW5mbyI6eyJzaGlwTmFtZUluZGljYXRvciI6IjAxIn0sImFjY3ROdW1iZXIiOiI1MTAwMDEwMDAwMDAwMDQ5IiwiZW1haWwiOiJzYW1wbGVAZXhhbXBsZS5jb20iLCJtY2MiOiI0MjI1IiwibWVyY2hhbnRDb3VudHJ5Q29kZSI6IjI1MCIsIm1lcmNoYW50TmFtZSI6IkRFTU8gU3RvcmUiLCJtZXNzYWdlQ2F0ZWdvcnkiOiIwMSIsIm5vdGlmaWNhdGlvblVSTCI6Imh0dHBzOi8vdGxzLXBhc3MucGF5emVuLmV1L3B1YmxpYy92MS8zZHN2Mi9ub3RpZnkvY3Jlcy8zNTcxNGY5NC00NDY0LTQ4OWEtODlkYi0wNTFhODhjMDkzYWUvTUFTVEVSQ0FSRCIsInB1cmNoYXNlQW1vdW50IjoiMCIsInB1cmNoYXNlQ3VycmVuY3kiOiI5NzgiLCJwdXJjaGFzZUV4cG9uZW50IjoiMiIsInB1cmNoYXNlRGF0ZSI6IjIwMjExMjA5MTUyNTQ0IiwidHJhbnNUeXBlIjoiMDEifSwiaWQiOiJTSU1VTEFUSU9OLUFSRVEiLCJuYW1lIjoiU0lNVUxBVElPTi1BUkVRIn1dLCJtZXNzYWdlVHlwZSI6IkNSZXEiLCJtZXNzYWdlVmVyc2lvbiI6IjIuMS4wIiwiYWNzVHJhbnNJRCI6ImMyMGZiYzg4LTNlMmQtNDg5NS04YTgxLWEzMjcyMGVhNWQ4ZSIsImNoYWxsZW5nZVdpbmRvd1NpemUiOiIwMyJ9",
                    "threeDSSessionData":"H4sIAAAAAAAAADVQ2bKiQAz9IqZaFtFHVu2Gbmx2eLFE2QVR4LJ8_XBrnIdTqSQnOSdJF1TFIQK3IO4iVgexA_fwKcvejmTY4Vey8FMIutBXYA9bW7grW7_-5o3ex8svH7m48ljYgj_pgqYoJCtl5-IWgNIqkRgq6BNucxtWW8fLFvuttv7WHme0i535Dlv5DqvuDmsCqTdj2xPOtn8k1BM06tu6rU-lueGxwXpOJV49Drt2Y7l0ICpliQKApT4L082F-AQHrHpz5OZ8tEoCZvXnV3P85wMR6hPP9pFKfaR9e-zX42JW2oi_evF_PRVtHkFpKqi7c_j3LrrtcGG5ccJigtVrJhUWsBqBzQ_I6B-flKI6SqMwXwxO-mkecWCYKSlW5Ipt1MRynMviMctIbaVDXCcF_CiNkFViHetATJquNHLjEPRnidxCaQ4zDf8cI2MeXVPTDuljY7Jl5Kuyf1muDdNRZ78_KdY1rZhAJnXel91et3OZG_ThsNrtiTCJdhX1D96d97M-fJB6ZiXBqN6ty_KBH0jOyE94th7VUZWexNXPLwt9inWaIsrxL3YYd6itnwvlEiadYOuIbnfkhEBg1LcZho0IkovcFKXnUS9bPNqLN2j2LyaR-8vV8aMTsHj9IEi2b0ZtRufcf4sHRrqS2cDM-4eYzkscY5Ds5nekNNtHwJgqh8FIs8GkzU1je6OX_gIGPxhSsQIAAA"
                },
                "_type":"V4/Charge/Authenticate/HttpRequest"
            },
            "_type":"V4/Charge/Authenticate/AuthenticationInstruction"
        },
        "_type":"V4/AuthenticationResponseData"
    }
}

3. 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.

4. Return via the browser with an instruction result.

{
	"eventName":"LYRA_AUTH_INSTRUCTION_RESULT",
	"value":{
		"name":"CHALLENGE",
		"value":"eyJjZXJ0aWZpY2F0ZSI6IlBBU1NfMS4zNy4wX0pXVCIsInR5cCI6IkpXVCIsImFsZyI6IlJTMjU2In0.eyJwYXNzQ2xhaW0iOiJ7XCJwcm90b2NvbFwiOntcIm5hbWVcIjpcIlRIUkVFRFNcIixcInZlcnNpb25cIjpcIjIuMS4wXCIsXCJuZXR3b3JrXCI6XCJNQVNURVJDQVJEXCIsXCJjaGFsbGVuZ2VQcmVmZXJlbmNlXCI6XCJDSEFMTEVOR0VfTUFOREFURURcIixcInNpbXVsYXRpb25cIjp0cnVlfSxcImF1dGhlbnRpY2F0aW9uUmVzdWx0XCI6e1wicmVzcG9uc2VUeXBlXCI6XCJSRVNVTFRcIixcInR5cGVcIjpcIkNIQUxMRU5HRVwiLFwiYXV0aGVudGljYXRpb25JZFwiOntcInR5cGVcIjpcImRzVHJhbnNJZFwiLFwidmFsdWVcIjpcIjMyYTcwNzM4LWFiZjAtNGRmMS1hNmYwLWZhZWViZjBiNWNhMVwifSxcImF1dGhlbnRpY2F0aW9uVmFsdWVcIjp7XCJ0eXBlXCI6XCJBQVZcIixcInZhbHVlXCI6XCJQa3VHQldwdUVENDNGTnFrQmgzcnFKaGkvakk9XCJ9LFwic3RhdHVzXCI6XCJTVUNDRVNTXCIsXCJjb21tZXJjZUluZGljYXRvclwiOlwiMDVcIixcImV4dGVuc2lvblwiOntcInR5cGVcIjpcIlRIUkVFRFNfVjJcIixcInRocmVlRFNTZXJ2ZXJUcmFuc0lEXCI6XCIzNTcxNGY5NC00NDY0LTQ4OWEtODlkYi0wNTFhODhjMDkzYWVcIixcImRzVHJhbnNJRFwiOlwiMzJhNzA3MzgtYWJmMC00ZGYxLWE2ZjAtZmFlZWJmMGI1Y2ExXCIsXCJhY3NUcmFuc0lEXCI6XCI4ZjlkZTNmZC0zMTRlLTQyY2MtYmNhMS1hN2UzYzRmNGQzNWVcIn0sXCJyZWFzb25cIjp7fX0sXCJldmVudHNcIjpbXSxcImlkXCI6XCIzNTcxNGY5NC00NDY0LTQ4OWEtODlkYi0wNTFhODhjMDkzYWVcIixcInNlc3Npb25EYXRhXCI6e1wia1wiOlwiM0RTMlwiLFwic1wiOnRydWUsXCJwXCI6XCJDSEFMTEVOR0VfTUFOREFURURcIixcInRcIjpcIjM1NzE0Zjk0LTQ0NjQtNDg5YS04OWRiLTA1MWE4OGMwOTNhZVwiLFwiblwiOlwiTUFTVEVSQ0FSRFwiLFwidlwiOlwiMi4xLjBcIixcImRcIjpcIjAyXCJ9fSIsImlzcyI6IlBBU1MiLCJleHAiOjE2MzkwNjQ3MTJ9.SgSxTm-kJm5EK-02IDqyNDYtyT2vEV_M267OgE3w1qXT_0979jupYh6wAfmluLgC1O5jz0BRQz4xx7IMPQUVEToIK3CXeR6-xS3Alk09FoKf8CiFHZFfqnEAbtR5-ISaW38hduiKJa9csU6qQh4Fs8RgPAAoR-lDhcQufjls0hOAAr2c4uSK4SXbCnDBVia9MhwiPUrlFSJea9DzfD79fjsrGyE2qaABU_kGZSge3gaoJ_r5VtcDd1mbjRWk011PajD9EfuhzM_UvOCn27HxsWYg1UATuEXC7eNEt49YKFRs07p7yWM4x5KikJa2_eTtSNL0b4CvTjL1FKFE3DrsMA",
		"protocol":{
			"name":"THREEDS",
			"version":"2.1.0",
			"network":"MASTERCARD",
			"challengePreference":"CHALLENGE_MANDATED",
			"simulation":true
		}
	}
}

5. New call to the PCI/Charge/CreateToken service passing the instruction result and the session ID (operationSessionId).

{
  "operationSessionId": "fae70e432ad14feda188873d105b0939",
  "instructionResult": {
    "name" : "CHALLENGE",			
    "protocol" : {
      "name" : "THREEDS",
      "network": "MASTERCARD",
      "version" : "2.1.0",
      "challengePreference": "CHALLENGE_MANDATED",
      "simulation": 1
    },
    "value": "eyJjZXJ0aWZpY2F0ZSI6IlBBU1NfMS4zNy4wX0pXVCIsInR5cCI6IkpXVCIsImFsZyI6IlJTMjU2In0.eyJwYXNzQ2xhaW0iOiJ7XCJwcm90b2NvbFwiOntcIm5hbWVcIjpcIlRIUkVFRFNcIixcInZlcnNpb25cIjpcIjIuMS4wXCIsXCJuZXR3b3JrXCI6XCJNQVNURVJDQVJEXCIsXCJjaGFsbGVuZ2VQcmVmZXJlbmNlXCI6XCJDSEFMTEVOR0VfTUFOREFURURcIixcInNpbXVsYXRpb25cIjp0cnVlfSxcImF1dGhlbnRpY2F0aW9uUmVzdWx0XCI6e1wicmVzcG9uc2VUeXBlXCI6XCJSRVNVTFRcIixcInR5cGVcIjpcIkNIQUxMRU5HRVwiLFwiYXV0aGVudGljYXRpb25JZFwiOntcInR5cGVcIjpcImRzVHJhbnNJZFwiLFwidmFsdWVcIjpcIjMyYTcwNzM4LWFiZjAtNGRmMS1hNmYwLWZhZWViZjBiNWNhMVwifSxcImF1dGhlbnRpY2F0aW9uVmFsdWVcIjp7XCJ0eXBlXCI6XCJBQVZcIixcInZhbHVlXCI6XCJQa3VHQldwdUVENDNGTnFrQmgzcnFKaGkvakk9XCJ9LFwic3RhdHVzXCI6XCJTVUNDRVNTXCIsXCJjb21tZXJjZUluZGljYXRvclwiOlwiMDVcIixcImV4dGVuc2lvblwiOntcInR5cGVcIjpcIlRIUkVFRFNfVjJcIixcInRocmVlRFNTZXJ2ZXJUcmFuc0lEXCI6XCIzNTcxNGY5NC00NDY0LTQ4OWEtODlkYi0wNTFhODhjMDkzYWVcIixcImRzVHJhbnNJRFwiOlwiMzJhNzA3MzgtYWJmMC00ZGYxLWE2ZjAtZmFlZWJmMGI1Y2ExXCIsXCJhY3NUcmFuc0lEXCI6XCI4ZjlkZTNmZC0zMTRlLTQyY2MtYmNhMS1hN2UzYzRmNGQzNWVcIn0sXCJyZWFzb25cIjp7fX0sXCJldmVudHNcIjpbXSxcImlkXCI6XCIzNTcxNGY5NC00NDY0LTQ4OWEtODlkYi0wNTFhODhjMDkzYWVcIixcInNlc3Npb25EYXRhXCI6e1wia1wiOlwiM0RTMlwiLFwic1wiOnRydWUsXCJwXCI6XCJDSEFMTEVOR0VfTUFOREFURURcIixcInRcIjpcIjM1NzE0Zjk0LTQ0NjQtNDg5YS04OWRiLTA1MWE4OGMwOTNhZVwiLFwiblwiOlwiTUFTVEVSQ0FSRFwiLFwidlwiOlwiMi4xLjBcIixcImRcIjpcIjAyXCJ9fSIsImlzcyI6IlBBU1MiLCJleHAiOjE2MzkwNjQ3MTJ9.SgSxTm-kJm5EK-02IDqyNDYtyT2vEV_M267OgE3w1qXT_0979jupYh6wAfmluLgC1O5jz0BRQz4xx7IMPQUVEToIK3CXeR6-xS3Alk09FoKf8CiFHZFfqnEAbtR5-ISaW38hduiKJa9csU6qQh4Fs8RgPAAoR-lDhcQufjls0hOAAr2c4uSK4SXbCnDBVia9MhwiPUrlFSJea9DzfD79fjsrGyE2qaABU_kGZSge3gaoJ_r5VtcDd1mbjRWk011PajD9EfuhzM_UvOCn27HxsWYg1UATuEXC7eNEt49YKFRs07p7yWM4x5KikJa2_eTtSNL0b4CvTjL1FKFE3DrsMA"
  }			  
}

6. Return from the payment gateway 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-09T15:30:15+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.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":"3631f62cb9974d7ba9c064938befac02",
                "amount":0,
                "currency":"EUR",
                "paymentMethodType":"CARD",
                "paymentMethodToken":"c6597239795a4415b2cc00142fb0aaf3",
                "status":"PAID",
                "detailedStatus":"ACCEPTED",
                "operationType":"VERIFICATION",
                "effectiveStrongAuthentication":"ENABLED",
                "creationDate":"2021-12-09T15:30:12+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":"MASTERCARD",
                        "pan":"510001XXXXXX0049",
                        "expiryMonth":11,
                        "expiryYear":2027,
                        "country":"FR",
                        "issuerCode":null,
                        "issuerName":null,
                        "effectiveProductCode":"MCC",
                        "legacyTransId":"924517",
                        "legacyTransDate":"2021-12-09T15:30:12+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":"35714f94-4464-489a-89db-051a88c093ae",
                            "operationSessionId":"fae70e432ad14feda188873d105b0939",
                            "protocol":{
                                "name":"THREEDS",
                                "version":"2.1.0",
                                "network":"MASTERCARD",
                                "challengePreference":"CHALLENGE_MANDATED",
                                "simulation":true,
                                "_type":"V4/Charge/Authenticate/Protocol"
                            },
                            "value":{
                                "authenticationType":"CHALLENGE",
                                "authenticationId":{
                                    "authenticationIdType":"dsTransId",
                                    "value":"32a70738-abf0-4df1-a6f0-faeebf0b5ca1",
                                    "_type":"V4/Charge/Authenticate/AuthenticationId"
                                },
                                "authenticationValue":{
                                    "authenticationValueType":"AAV",
                                    "value":"P**************************=",
                                    "_type":"V4/Charge/Authenticate/AuthenticationValue"
                                },
                                "status":"SUCCESS",
                                "commerceIndicator":"05",
                                "extension":{
                                    "authenticationType":"THREEDS_V2",
                                    "threeDSServerTransID":"35714f94-4464-489a-89db-051a88c093ae",
                                    "dsTransID":"32a70738-abf0-4df1-a6f0-faeebf0b5ca1",
                                    "acsTransID":"8f9de3fd-314e-42cc-bca1-a7e3c4f4d35e",
                                    "_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-09T15:30:12+00:00",
                            "authorizationNumber":"3fe7c0",
                            "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":"e8fe2bdc63cf438591fa3ea6793e668b",
    "serverDate":"2021-12-09T15:30:15+00:00",
    "applicationProvider":"",
    "metadata":null,
    "mode":"TEST",
    "serverUrl":"https://api-sogecommerce.societegenerale.eu",
    "_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-09T15:31:56+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.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":"02cfabfea04c4db7983d0467063dca99",
                "amount":0,
                "currency":"EUR",
                "paymentMethodType":"CARD",
                "paymentMethodToken":null,
                "status":"UNPAID",
                "detailedStatus":"REFUSED",
                "operationType":"VERIFICATION",
                "effectiveStrongAuthentication":"DISABLED",
                "creationDate":"2021-12-09T15:31:54+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":"MASTERCARD",
                        "pan":"510001XXXXXX0049",
                        "expiryMonth":11,
                        "expiryYear":2027,
                        "country":"FR",
                        "issuerCode":null,
                        "issuerName":null,
                        "effectiveProductCode":"MCC",
                        "legacyTransId":"948164",
                        "legacyTransDate":"2021-12-09T15:31:54+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":"35714f94-4464-489a-89db-051a88c093ae",
                            "operationSessionId":"fae70e432ad14feda188873d105b0939",
                            "protocol":{
                                "name":"THREEDS",
                                "version":"2.1.0",
                                "network":"MASTERCARD",
                                "challengePreference":"CHALLENGE_MANDATED",
                                "simulation":true,
                                "_type":"V4/Charge/Authenticate/Protocol"
                            },
                            "value":{
                                "authenticationType":"CHALLENGE",
                                "authenticationId":{
                                    "authenticationIdType":"dsTransId",
                                    "value":"f7911a83-f8fe-46d8-98f3-e5d4582fa1ba",
                                    "_type":"V4/Charge/Authenticate/AuthenticationId"
                                },
                                "status":"FAILED",
                                "extension":{
                                    "authenticationType":"THREEDS_V2",
                                    "threeDSServerTransID":"c9bd4f5f-01da-42d9-b7a4-85d1d0e10009",
                                    "dsTransID":"f7911a83-f8fe-46d8-98f3-e5d4582fa1ba",
                                    "acsTransID":"ec39a67d-95be-445c-85a9-a71bf51181f6",
                                    "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":"1716c9204e8b4fa693afc2feaf1ac5eb",
    "serverDate":"2021-12-09T15:31:56+00:00",
    "applicationProvider":"",
    "metadata":null,
    "mode":"TEST",
    "serverUrl":"https://api-sogecommerce.societegenerale.eu",
    "_type":"V4/WebService/Response"
}
© 2025 {'|'} All rights reserved to Sogecommerce
25.24-1.11