This page is for our Classic API (
/authorise) integration. If you are integrating using our Checkout APIs, refer to the authorisation-only integration on Checkout API documentation instead.
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.
To authorise a 3D Secure 1 authenticated payment, you need the following data:
Send a payment authorisation request with 3D Secure authentication data
Make a POST /authorise request and include the following:
If you are authorising for a co-branded card, you need to set the paymentMethod.type value to the scheme that authenticated the payment. For example, if you are authorising for a card co-branded with Visa and Cartes Bancaires, set the value to either
cartebancaire, depending on which scheme performed the authentication. Otherwise, the authorisation can be refused.
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.