Data-only flow

In a regular 3D Secure 2 flow, the payment has to be authenticated by the issuer before it can be authorised. In a data-only flow, you send the same 3D Secure 2 data but the schemes directly handle the authentication request. The data-only request goes directly to the scheme, and then the scheme includes their own risk data in the authorisation message before sending it to the issuer.

Using the data-only flow

The data-only flow allows you to use the scheme's 3D Secure-specific risk scoring models, which helps increase your authorisation rates in specific markets, without incurring additional fees.

You can also use the data-only flow when you integrate with Adyen as a standalone 3D Secure 2 provider with an authentication-only implementation.

Because there is no authentication request sent to the issuer in a data-only flow, your shoppers will not be presented with a 3D Secure 2 challenge.

Before you begin

Before you can start accepting 3D Secure 2 authenticated transactions on browsers or in-app, make sure that you:

1. Sign up for an Adyen test account at https://www.adyen.com/signup. 
2. Get your API Key. Save a copy as you'll need it for API calls you make to the Adyen payments platform.
3. Install one of our Libraries to connect with the Adyen APIs. For more information on these steps, refer to Get started with Adyen.

Submit a data-only payment request

To indicate that you want to use the data-only flow, specify in your /authorise  request:

• additionalData.threeDS2DataOnly: true

Other required fields and the response to your /authorise request are the same as in case of a regular 3D Secure flow, depending on your integration.

For more information, refer to Browser-based integration, iOS 3D Secure 2 SDK, Android 3D Secure 2 SDK, or Authentication-only integration.

Request

curl https://pal-test.adyen.com/pal/servlet/Payment/v50/authorise \
-H 'x-api-key: ADYEN_API_KEY' \
-H 'content-type: application/json' \
-d '{
    ...
    "additionalData": {
      "threeDS2DataOnly": true
    },
    ...
  }'

Testing the data-only flow

Use the test card below to try the 3D Secure 2 data-only flow.