Get 3DS Session Details

This method returns the details of a 3DS session and indicates the outcome of the 3DS authentication.

note

This endpoint uses the SmartPay BaseURL and Authorization.

Request

Parameter	Description	Type	Required
id	Id to be obtained from the Create 3DS Session endpoint.	String	Yes

Path:

GET {baseUrl}/3ds-sessions/{id}

Header:

Content-Type: application/json
Accept-Language: en-US
Authorization: Basic M2lwN2Yx...OGU3Mg==

Response

Status Code:

200 (3DS authentication status successfully returned)

Header:

Content-Type: application/json
Accept-Language: en-US

{
  "3ds": {
    "version": "3DS2",
    "3ds2": {
      "3dsMethod": {
        "redirectHtml": "<div id=\"initiate3dsSimpleRedirect\" xmlns=\"http://www.w3.org/1999/html\"> <iframe id=\"methodFrame\" name=\"methodFrame\" height=\"100\" width=\"200\" > </iframe> <form id =\"initiate3dsSimpleRedirectForm\" method=\"POST\" action=\"https://na.gateway.mastercard.com/acs/mastercard/v2/method\" target=\"methodFrame\"> <input type=\"hidden\" name=\"threeDSMethodData\" value=\"eyJ0aHJlZURTTWV0aG9kTm90aWZpY2F0aW9uVVJMIjoiaHR0cHM6Ly9uYS5nYXRld2F5Lm1hc3RlcmNhcmQuY29tL2NhbGxiYWNrSW50ZXJmYWNlL2dhdGV3YXkvMWU3NzJhODhiMDJjODA1ZjEzNjM3ZWU2NjM2YjI3MzM5YzEyMzQxZmNjNjM4ZjZmOTk5NGMyY2I2ZGVjNmQxMyIsInRocmVlRFNTZXJ2ZXJUcmFuc0lEIjoiN2VmZjRhN2EtMWQ0NC00MzczLWJlYTgtNGU4ZWM0YWI5N2M3In0=\" /> </form> <script id=\"initiate-authentication-script\"> var e=document.getElementById(\"initiate3dsSimpleRedirectForm\"); if (e) { e.submit(); if (e.parentNode !== null) { e.parentNode.removeChild(e); } } </script> </div>",
        "3dsMethodPostData": "eyJ0aHJlZURTTWV0aG9kTm90aWZpY2F0aW9uVVJMIjoiaHR0cHM6Ly9uYS5nYXRld2F5Lm1hc3RlcmNhcmQuY29tL2NhbGxiYWNrSW50ZXJmYWNlL2dhdGV3YXkvMWU3NzJhODhiMDJjODA1ZjEzNjM3ZWU2NjM2YjI3MzM5YzEyMzQxZmNjNjM4ZjZmOTk5NGMyY2I2ZGVjNmQxMyIsInRocmVlRFNTZXJ2ZXJUcmFuc0lEIjoiN2VmZjRhN2EtMWQ0NC00MzczLWJlYTgtNGU4ZWM0YWI5N2M3In0=",
        "3dsMethodUrl": "https://na.gateway.mastercard.com/acs/mastercard/v2/method"
      },
      "challengeData": {
        "acsUrl": "https://na.gateway.mastercard.com/acs/mastercard/v2/prompt",
        "cReq": "eyJ0aHJlZURTU2VydmVyVHJhbnNJRCI6IjdlZmY0YTdhLTFkNDQtNDM3My1iZWE4LTRlOGVjNGFiOTdjNyJ9",
        "redirectHtml": "<div id=\"threedsChallengeRedirect\" xmlns=\"http://www.w3.org/1999/html\" style=\" height: 100vh\"> <form id =\"threedsChallengeRedirectForm\" method=\"POST\" action=\"https://na.gateway.mastercard.com/acs/mastercard/v2/prompt\" target=\"challengeFrame\"> <input type=\"hidden\" name=\"creq\" value=\"eyJ0aHJlZURTU2VydmVyVHJhbnNJRCI6IjdlZmY0YTdhLTFkNDQtNDM3My1iZWE4LTRlOGVjNGFiOTdjNyJ9\" /> </form> <iframe id=\"challengeFrame\" name=\"challengeFrame\" width=\"100%\" height=\"100%\" ></iframe> <script id=\"authenticate-payer-script\"> var e=document.getElementById(\"threedsChallengeRedirectForm\"); if (e) { e.submit(); if (e.parentNode !== null) { e.parentNode.removeChild(e); } } </script> </div>"
      },
      "acsEci": "02",
      "authenticationToken": "kHyn+7YFi1EUAREAAAAvNUe6Hv8=",
      "transactionId": "68f92ff6-c417-40df-bfaf-6518c43f40fb",
      "3dsServerTransactionId": "7eff4a7a-1d44-4373-bea8-4e8ec4ab97c7",
      "acsTransactionId": "0571d1c1-df05-4a6b-83c9-b6d1617a64f6",
      "directoryServerId": "A999999999",
      "dsTransactionId": "68f92ff6-c417-40df-bfaf-6518c43f40fb",
      "methodCompleted": true,
      "methodSupported": "SUPPORTED",
      "protocolVersion": "2.1.0",
      "requestorId": "MAS00001_INT_MPGS_NATEA7C2FAQ89PE83",
      "requestorName": "Client",
      "transactionStatus": "Y"
    }
  },
  "device": {
    "browser": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36 Edg/122.0.0.0",
    "browserDetails": {
      "acceptHeaders": "application/json",
      "colorDepth": 24,
      "javaEnabled": false,
      "javaScriptEnabled": false,
      "language": "en",
      "screenHeight": 1284,
      "screenWidth": 1674,
      "3DSecureChallengeWindowSize": "FULL_SCREEN"
    },
    "ipAddress": "192.224.73.15"
  }
}

important

From the received response, please extract the mandatory 6 parameters below and be prepared to provide those parameters for the endpoints Create 3DS Payment or Card on File.

• acsEci
• authenticationToken
• transactionStatus
• protocolVersion
• dsTransactionId
• acsTransactionId