---
title: "3D Secure authentication"
description: "Explore your 3D Secure authentication options."
url: "https://docs.adyen.com/online-payments/classic-integrations/classic-api-integration/3d-secure-authentication"
source_url: "https://docs.adyen.com/online-payments/classic-integrations/classic-api-integration/3d-secure-authentication.md"
canonical: "https://docs.adyen.com/online-payments/classic-integrations/classic-api-integration/3d-secure-authentication"
last_modified: "2019-08-28T16:26:00+02:00"
language: "en"
---

# 3D Secure authentication

Explore your 3D Secure authentication options.

[View source](/online-payments/classic-integrations/classic-api-integration/3d-secure-authentication.md)

**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 [3D Secure on Checkout API](/online-payments/3d-secure) integration. To use this newer integration, you must also [migrate to the Checkout API](/online-payments/upgrade-your-integration/migrate-to-checkout-api).

3D Secure is an authentication protocol that provides an additional layer of verification for card-not-present (CNP) transactions. We recommend that you use 3D Secure to:

* Comply with authentication regulations for online payments, such as [PSD2 SCA](/online-payments/psd2-sca-compliance-and-implementation-guide).
* Avail of the [liability shift](/online-payments/3d-secure-for-regulation-compliance#3dsecurechargebackliabilityshiftrules). When a transaction has been authenticated through 3D Secure, the liability for fraudulent chargebacks shifts from you to the issuing bank.

If you have an existing integration with Adyen, see the section on [adding 3D Secure to your Adyen integration](#3d-secure-2-implementation-options).

## Understanding 3D Secure versions

3D Secure has two available versions:

* **3D Secure 2**: New version expected to fully replace 3D Secure 1 by 2020/2021. Unlike the previous version where shoppers are redirected to another site, in 3D Secure 2 the card issuer performs the authentication within your app or payment form. The issuing bank may verify the shopper's identity using passive, biometric, and two-factor authentication approaches.
* **3D Secure 1**: Before a payment is authenticated, shoppers are redirected to the card issuer's site to provide additional authentication data such as a password or an SMS verification code. The redirection introduced in 3D Secure 1 might lead to lower conversion rates due to technical errors during the redirection or due to shoppers dropping out of the authentication process.

Until card schemes fully decommission 3D Secure 1 by 2020/2021, we expect that some issuing banks will continue to support and require 3D Secure 1. This means that you should be able to handle both 3D Secure 1 and 3D Secure 2 authentication transactions on your checkout page.

## Your 3D Secure implementation options

We provide the following options to support both 3D Secure versions with your API integration:

* **Redirect authentication**: If you already have an existing integration with Adyen, this is the fastest way to support both 3D Secure 1 and 3D Secure 2. We will check which version the issuer supports and provide a redirect URL where your shopper can complete either the 3D Secure 1 or a 3D Secure 2 authentication.

* **Native 3DS2 + Redirect 3DS1**: Use our 3D Secure 2 [helper functions for Web](/online-payments/classic-integrations/classic-api-integration/3d-secure-authentication/native-3ds2/browser-based-integration) and SDKs for [iOS](/online-payments/classic-integrations/classic-api-integration/3d-secure-authentication/native-3ds2/ios-sdk-integration) and [Android](/online-payments/classic-integrations/classic-api-integration/3d-secure-authentication/native-3ds2/android-sdk-integration) to perform 3D Secure 2 authentication within your site or mobile app. Based on issuer performance, our Authentication Engine might also route the payment to the 3D Secure 1 flow. For [3D Secure 1](/online-payments/classic-integrations/classic-api-integration/3d-secure-authentication/3d-secure-1) authentication, you should handle the redirect on your client-side implementation.

Click on the options below if you want to learn about the integration steps. If you have an existing integration with us and want to know how you can support 3D Secure 2, proceed to [3D Secure 2 with your existing Adyen integration](#3d-secure-2-implementation-options).

###### [Redirect](/online-payments/classic-integrations/classic-api-integration/3d-secure-authentication/3d-secure-1)

[Support both 3D Secure 1 and 3D Secure 2 authentication through a redirect. This is the quickest way to start supporting both versions for PSDS2 SCA compliance.](/online-payments/classic-integrations/classic-api-integration/3d-secure-authentication/3d-secure-1)

###### [Native 3DS2 + Redirect 3DS1](/online-payments/classic-integrations/classic-api-integration/3d-secure-authentication/native-3ds2)

[Support 3D Secure 2 natively and 3D Secure 1 through a redirect. This provides a better shopper experience and is a future-proof way for authenticating payments.](/online-payments/classic-integrations/classic-api-integration/3d-secure-authentication/native-3ds2)

## Implementing 3D Secure 2 with your existing Adyen integration

If you are using our Checkout SDKs, HPP, Plugins, or API with 3D Secure 1 integration, you do not have change anything. You can already support 3D Secure 2 authentication through the same redirect page.

If you have an existing integration with us with a 3D Secure 1 implementation, you can already support 3D Secure 2. Similar to a 3D Secure 1 flow, you will need to redirect the shopper to the URL returned in the API response. If a transaction requires 3D Secure 2 authentication, we will provide a redirect URL which will take your shopper to our hosted page to complete the 3D Secure 2 authentication flow.

In the table below we discuss in detail how we will handle 3D Secure 2 across different integrations, and what you can do to improve the shopper experience should you choose to implement native 3D Secure 2 authentication.

|                                                                         |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ----------------------------------------------------------------------- |   |
| Your existing Adyen integration                                         | What you need to do to support 3D Secure 2                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Online payments API, with existing 3D Secure 1 integration.             | Do nothing. 3D Secure 2 will be supported through a redirect. However, if you want a better shopper experience, [add 3D Secure 2 Components](/online-payments/3d-secure/native-3ds2) or use[Drop-in](/online-payments/drop-in-web) on your client-side implementation.                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Quick integration Checkout SDKs                                         | Do nothing. 3D Secure 2 will be supported in Web, iOS, and Android SDKs through a redirect. However, if you want a better shopper experience with native 3D Secure 2 authentication, switch to our [Web](/online-payments/drop-in-web), [iOS](/online-payments/ios/drop-in), and [Android Drop-in](/online-payments/android/drop-in) solution available from versions 3.0.0 and later. If you want to continue using the mobile SDKs, you can upgrade to the following versions which support 3D Secure 2:- [Checkout Android SDK version 2.4.0 to 2.4.5](https://github.com/Adyen/adyen-android/releases).
- [Checkout iOS SDK version 2.6.0 to 2.8.4](https://github.com/Adyen/adyen-ios/releases) |
| Plugins for Magento 1 and 2, PrestaShop, SFCC, or SAP Commerce (Hybris) | Upgrade to the following plugin versions to support native 3D Secure 2 authentication:- [Magento 2 version 4.2.0 and later](https://github.com/Adyen/adyen-magento2).
- [Salesforce Commerce Cloud version 19.1.0 and later](https://github.com/Adyen/adyen-salesforce-commerce-cloud).
- [SAP Commerce (Hybris) version 5.0.0 and later](https://github.com/Adyen/adyen-hybris).
- [PrestaShop version 1.0.0 and later](https://github.com/Adyen/adyen-prestashop).If you choose to continue using an older version of our plugins, we will support 3D Secure 2 through a redirect.                                                                                                                 |
| Hosted Payment Pages (HPP)                                              | Do nothing. 3D Secure 2 will be supported through a redirect. However, we strongly recommend to move your implementation to our [online payments API](/online-payments/drop-in-web/) with the[ 3D Secure 2 Component](/online-payments/3d-secure/native-3ds2) for a better user experience.                                                                                                                                                                                                                                                                                                                                                                                                          |
| Classic integration or CSE, with existing 3D Secure 1 integration.      | Do nothing. 3D Secure 2 will be supported through a redirect. However, if you want a better shopper experience with native 3D Secure 2 authentication, use our [helper functions](/online-payments/classic-integrations/classic-api-integration/3d-secure-authentication/native-3ds2/browser-based-integration/3d-secure-2-helper-functions) for web and the [Classic integration 3D Secure 2 SDKs](/online-payments/classic-integrations/classic-api-integration/3d-secure-authentication/native-3ds2/) for mobile.                                                                                                                                                                                 |
| Online payments API, without a 3D Secure 1 integration.                 | Integrate [3D Secure redirect authentication](/online-payments/3d-secure/redirect-3ds2/) to support both versions of 3D Secure or a combination of [3D Secure 2 native authentication](/online-payments/3d-secure/native-3ds2) and a [3D Secure 1 fallback.](/online-payments/3d-secure/redirect-3ds2-3ds1/)                                                                                                                                                                                                                                                                                                                                                                                         |
| Classic integration or CSE, without a 3D Secure 1 integration.          | Integrate [3D Secure classic API redirect authentication](/online-payments/classic-integrations/classic-api-integration/3d-secure-authentication/3d-secure-1/) to support both versions of 3D Secure or a combination of [3D Secure 2 native authentication](/online-payments/classic-integrations/classic-api-integration/3d-secure-authentication/native-3ds2) and a [3D Secure 1 fallback.](/online-payments/classic-integrations/classic-api-integration/3d-secure-authentication/3d-secure-1)                                                                                                                                                                                                   |

For guidelines on using 3D Secure with your current business model, see [PSD2 SCA compliance and implementation guide](/online-payments/psd2-sca-compliance-and-implementation-guide).

## Next steps

[PSD2 SCA compliance guide](/online-payments/psd2-sca-compliance-and-implementation-guide)

[Understand how your business model can be PSD2 SCA-compliant with 3D Secure.](/online-payments/psd2-sca-compliance-and-implementation-guide)

[Classic API and 3D Secure 2](/online-payments/classic-integrations/classic-api-integration/3d-secure-authentication/native-3ds2)

[Learn how you can implement 3D Secure 2 with your classic API integration.](/online-payments/classic-integrations/classic-api-integration/3d-secure-authentication/native-3ds2)
