ThreeDSecureData

To authorise payments with Adyen using 3D Secure authenticated data, send an /authorise request with an mpiData object containing the following parameters. Get the values from the authentication data produced by a 3DS 1.0 MPI (Mastercard SecureCode or Verified By Visa) or a 3DS 2.0 provider.

Field Type Required Description
authenticationResponse String (error)

In 3DS 1.0, this is the authentication response if a shopper was redirected.

In 3DS 2.0, include this parameter if the transaction goes through a challenge authentication flow. This is the transStatus from the last CRes (Challenge Response) message from the ACS to the 3D Secure client or in the RRes (Results Request) from ACS to 3D Secure server sent after the shopper completes the challenge.

cavv String (error) This is the cardholder authentication value (base64 encoded, 20 bytes in a decoded form).
cavvAlgorithm String (error) Include this only for 3DS 1.0. The CAVV algorithm used.
directoryResponse String (error)

The enrollment response from the directory server.

In 3D Secure 2.0 specifications, this is the transStatus from the ARes (Authentication Request) message sent by the ACS to the 3D Secure provider.

eci String (error)

The electronic commerce indicator.

xid String (error)

The transaction identifier assigned by directory server (base64 encoded, 20 bytes in a decoded form).

This is the dsTransID in 3D Secure 2.0 specifications.

threeDSVersion String (error) Include this only for 3DS 2.0. The current supported version is 2.1.0.