Authorise a payment with 3D Secure 2 authenticated data

Submit a payment authorisation with Adyen, using authentication data from a third-party 3D Secure 2 provider.

Adyen is no longer developing the Classic API integration

This page is for the Classic API (/authorise) integration, which we no longer accept new integrations with.

We strongly recommend migrating to the newer authorisation-only integration on Checkout API integration. To use this newer integration, you must also migrate to the Checkout API.

Before you begin

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

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

Get authentication data

If you didn't authenticate with Adyen, refer to Mapping Adyen parameters to EMVCo ones.

Send a payment authorisation request with 3D Secure authentication data

Co-badged cards

If you are authorising for a co-badged card, you need to set the selectedBrand value to the scheme that authenticated the payment. For example, if you are authorising for a card co-badged with Visa and Cartes Bancaires, set the value to either visa or cartebancaire, depending on which scheme performed the authentication. Otherwise, the authorisation can be refused.

Sample request

Sample response

You will receive an Authorised resultCode if the payment authorisation was successful. Otherwise, see Result codes for a complete list of values and the actions that you need to take.