Get the 3DS2 authentication result

post/retrieve3ds2Result

API Version

Retrieves the threeDS2Result after doing a 3D Secure 2 authentication only.

Endpoint destination URL

https://pal-test.adyen.com/pal/servlet/Payment/v68/retrieve3ds2Result

Request Parameters

Required

Optional

The merchant account identifier, with which you want to process the transaction.

The pspReference returned in the /authorise call.

Response parameters

After submitting a call, you receive a response message to inform you that your request was received and processed.

Depending on the HTTP status code of the response message, it is helpful to build some logic to handle any errors that a request or the system may return.

HTTP Responses

200 - OK
The request has succeeded.
threeDS2Resultobject
The result of the 3D Secure 2 authentication.
authenticationValuestring
The authenticationValue value as defined in the 3D Secure 2 specification.
cavvAlgorithmstring
The algorithm used by the ACS to calculate the authentication value, only for Cartes Bancaires integrations.
challengeCancelstring
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.
dsTransIDstring
The dsTransID value as defined in the 3D Secure 2 specification.
ecistring
The eci value as defined in the 3D Secure 2 specification.
exemptionIndicatorstring
Indicates the exemption type that was applied by the issuer to the authentication, if exemption applied. Allowed values:

lowValue

secureCorporate

trustedBeneficiary

transactionRiskAnalysis

messageVersionstring
The messageVersion value as defined in the 3D Secure 2 specification.
riskScorestring
Risk score calculated by Cartes Bancaires Directory Server (DS).
threeDSRequestorChallengeIndstring
Indicates whether a challenge is requested for this transaction. Possible values:

01 — No preference

02 — No challenge requested

03 — Challenge requested (3DS Requestor preference)

04 — Challenge requested (Mandate)

05 — No challenge (transactional risk analysis is already performed)

06 — Data Only

threeDSServerTransIDstring
The threeDSServerTransID value as defined in the 3D Secure 2 specification.
timestampstring
The timestamp value of the 3D Secure 2 authentication.
transStatusstring
The transStatus value as defined in the 3D Secure 2 specification.
transStatusReasonstring
Provides information on why the transStatus field has the specified value. For possible values, refer to our docs.
whiteListStatusstring
The whiteListStatus value as defined in the 3D Secure 2 specification.
400 - Bad Request
A problem reading or understanding the request.
additionalDataobject
Contains additional information about the payment. Some data fields are included only if you select them first. Go to Customer Area > Developers > Additional data.
errorCodestring
The error code mapped to the error message.
errorTypestring
The category of the error.
messagestring
A short explanation of the issue.
pspReferencestring
The PSP reference of the payment.
statusinteger
The HTTP response status.
401 - Unauthorized
Authentication required.
additionalDataobject
Contains additional information about the payment. Some data fields are included only if you select them first. Go to Customer Area > Developers > Additional data.
errorCodestring
The error code mapped to the error message.
errorTypestring
The category of the error.
messagestring
A short explanation of the issue.
pspReferencestring
The PSP reference of the payment.
statusinteger
The HTTP response status.
403 - Forbidden
Insufficient permissions to process the request.
additionalDataobject
Contains additional information about the payment. Some data fields are included only if you select them first. Go to Customer Area > Developers > Additional data.
errorCodestring
The error code mapped to the error message.
errorTypestring
The category of the error.
messagestring
A short explanation of the issue.
pspReferencestring
The PSP reference of the payment.
statusinteger
The HTTP response status.
422 - Unprocessable Entity
A request validation error.
additionalDataobject
Contains additional information about the payment. Some data fields are included only if you select them first. Go to Customer Area > Developers > Additional data.
errorCodestring
The error code mapped to the error message.
errorTypestring
The category of the error.
messagestring
A short explanation of the issue.
pspReferencestring
The PSP reference of the payment.
statusinteger
The HTTP response status.
500 - Internal Server Error
The server could not process the request.
additionalDataobject
Contains additional information about the payment. Some data fields are included only if you select them first. Go to Customer Area > Developers > Additional data.
errorCodestring
The error code mapped to the error message.
errorTypestring
The category of the error.
messagestring
A short explanation of the issue.
pspReferencestring
The PSP reference of the payment.
statusinteger
The HTTP response status.

Get the 3DS2 authentication result

HTTP Responses

200 - OK

400 - Bad Request

401 - Unauthorized

403 - Forbidden

422 - Unprocessable Entity

500 - Internal Server Error