Adyen Payment API
  1. General
Adyen Payment API
  • Modifications
    • Change the authorised amount
      POST
    • Cancel an authorisation
      POST
    • Cancel or refund a payment
      POST
    • Capture an authorisation
      POST
    • Create a donation
      POST
    • Refund a captured payment
      POST
    • Cancel an authorisation using your reference
      POST
    • Cancel an in-person refund
      POST
  • General
    • Create an authorisation
      POST
    • Complete a 3DS authorisation
      POST
    • Complete a 3DS2 authorisation
      POST
    • Get the 3DS authentication result
      POST
    • Get the 3DS2 authentication result
      POST
  1. General

Get the 3DS2 authentication result

POST
/retrieve3ds2Result
General
Retrieves the threeDS2Result after doing a 3D Secure 2 authentication only.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/retrieve3ds2Result' \
--header 'Content-Type: application/json' \
--data-raw '{
    "merchantAccount": "string",
    "pspReference": "string"
}'
Response Response Example
200 - Example 1
{
    "threeDS2Result": {
        "authenticationValue": "string",
        "cavvAlgorithm": "string",
        "challengeCancel": "01",
        "challengeIndicator": "noPreference",
        "dsTransID": "string",
        "eci": "string",
        "exemptionIndicator": "lowValue",
        "messageVersion": "string",
        "riskScore": "string",
        "threeDSServerTransID": "string",
        "timestamp": "string",
        "transStatus": "string",
        "transStatusReason": "string",
        "whiteListStatus": "string"
    }
}

Request

Body Params application/json
merchantAccount
string 
required
The merchant account identifier, with which you want to process the transaction.
pspReference
string 
required
The pspReference returned in the /authorise call.
Examples

Responses

🟢200OK - the request has succeeded.
application/json
Body
threeDS2Result
object (ThreeDS2Result) 
optional
The result of the 3D Secure 2 authentication.
authenticationValue
string 
optional
The authenticationValue value as defined in the 3D Secure 2 specification.
cavvAlgorithm
string 
optional
The algorithm used by the ACS to calculate the authentication value, only for Cartes Bancaires integrations.
challengeCancel
enum<string> 
optional
Indicator informing the Access Control Server (ACS) and the Directory Server (DS) that the authentication has been cancelled. For possible values, refer to 3D Secure API reference.
Allowed values:
01020304050607
challengeIndicator
enum<string> 
optional
Specifies a preference for receiving a challenge from the issuer.
Allowed values:
noPreference
requestNoChallenge
requestChallenge
requestChallengeAsMandate
Allowed values:
noPreferencerequestNoChallengerequestChallengerequestChallengeAsMandate
dsTransID
string 
optional
The dsTransID value as defined in the 3D Secure 2 specification.
eci
string 
optional
The eci value as defined in the 3D Secure 2 specification.
exemptionIndicator
enum<string> 
optional
Indicates the exemption type that was applied by the issuer to the authentication, if exemption applied.
Allowed values:
lowValue
secureCorporate
trustedBeneficiary
transactionRiskAnalysis
Allowed values:
lowValuesecureCorporatetrustedBeneficiarytransactionRiskAnalysis
messageVersion
string 
optional
The messageVersion value as defined in the 3D Secure 2 specification.
riskScore
string 
optional
Risk score calculated by Cartes Bancaires Directory Server (DS).
threeDSServerTransID
string 
optional
The threeDSServerTransID value as defined in the 3D Secure 2 specification.
timestamp
string 
optional
The timestamp value of the 3D Secure 2 authentication.
transStatus
string 
optional
The transStatus value as defined in the 3D Secure 2 specification.
transStatusReason
string 
optional
Provides information on why the transStatus field has the specified value. For possible values, refer to our docs.
whiteListStatus
string 
optional
The whiteListStatus value as defined in the 3D Secure 2 specification.
🟠400Bad Request - a problem reading or understanding the request.
🟠401Unauthorized - authentication required.
🟠403Forbidden - insufficient permissions to process the request.
🟠422Unprocessable Entity - a request validation error.
🔴500Internal Server Error - the server could not process the request.
Modified at 2023-08-15 08:20:06
Previous
Get the 3DS authentication result
Built with