Get the 3DS authentication result

post/getAuthenticationResult

API Version

Return the authentication result after doing a 3D Secure authentication only.

Endpoint destination URL

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

Request Parameters

Required

Optional

The merchant account identifier, with which the authentication was processed.

The pspReference identifier for the transaction.

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.
threeDS1Resultobject
The result of the 3D Secure authentication.
cavvstring
The cardholder authentication value (base64 encoded).
cavvAlgorithmstring
The CAVV algorithm used.
ecistring
3D Secure Electronic Commerce Indicator (ECI).
threeDAuthenticatedResponsestring
The authentication response from the ACS.
threeDOfferedResponsestring
Whether 3D Secure was offered or not.
xidstring
A unique transaction identifier generated by the MPI on behalf of the merchant to identify the 3D Secure transaction, in Base64 encoding.
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 3DS authentication result

HTTP Responses

200 - OK

400 - Bad Request

401 - Unauthorized

403 - Forbidden

422 - Unprocessable Entity

500 - Internal Server Error