{"title":"3D Secure authentication","category":"default","creationDate":1556550900,"content":"<div class=\"sc-notice warning\"><div>\n<p><strong>Adyen is no longer developing the Classic API integration<\/strong><\/p>\n<p>This page is for the Classic API (<code>\/authorise<\/code>) integration, which we no longer accept new integrations with. <\/p>\n<p>We strongly recommend migrating to the newer <a href=\"\/online-payments\/3d-secure\">3D Secure on Checkout API<\/a> integration. To use this newer integration, you must also <a href=\"\/pt\/online-payments\/upgrade-your-integration\/migrate-to-checkout-api\">migrate to the Checkout API<\/a>.<\/p>\n<\/div><\/div>\n<p>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:<\/p>\n<ul>\n<li>Comply with authentication regulations for online payments, such as <a href=\"\/pt\/online-payments\/psd2-sca-compliance-and-implementation-guide\">PSD2 SCA<\/a>.<\/li>\n<li>Avail of the <a href=\"\/pt\/online-payments\/3d-secure-for-regulation-compliance#3dsecurechargebackliabilityshiftrules\">liability shift<\/a>. When a transaction has been authenticated through 3D Secure, the liability for fraudulent chargebacks shifts from you to the issuing bank.<\/li>\n<\/ul>\n<div class=\"sc-notice info\"><div>\n<p>If you have an existing integration with Adyen, see the section on <a href=\"#3d-secure-2-implementation-options\">adding 3D Secure to your Adyen integration<\/a>.<\/p>\n<\/div><\/div>\n<h2>Understanding 3D Secure versions<\/h2>\n<p>3D Secure has two available versions:<\/p>\n<ul>\n<li><strong>3D Secure 2<\/strong>: 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.<\/li>\n<li><strong>3D Secure 1<\/strong>: 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.<\/li>\n<\/ul>\n<p>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.<\/p>\n<h2>Your 3D Secure implementation options<\/h2>\n<p>We provide the following options to support both 3D Secure versions with your API integration:<\/p>\n<ul>\n<li>\n<p><strong>Redirect authentication<\/strong>: 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.<\/p>\n<\/li>\n<li>\n<p><strong>Native 3DS2 + Redirect 3DS1<\/strong>: Use our 3D Secure 2 <a href=\"\/pt\/online-payments\/classic-integrations\/classic-api-integration\/3d-secure-authentication\/native-3ds2\/browser-based-integration\">helper functions for Web<\/a> and SDKs for <a href=\"\/pt\/online-payments\/classic-integrations\/classic-api-integration\/3d-secure-authentication\/native-3ds2\/ios-sdk-integration\">iOS<\/a> and <a href=\"\/pt\/online-payments\/classic-integrations\/classic-api-integration\/3d-secure-authentication\/native-3ds2\/android-sdk-integration\">Android<\/a> 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 <a href=\"\/pt\/online-payments\/classic-integrations\/classic-api-integration\/3d-secure-authentication\/3d-secure-1\">3D Secure 1<\/a> authentication, you should handle the redirect on your client-side implementation.<\/p>\n<\/li>\n<\/ul>\n<p>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 <a href=\"#3d-secure-2-implementation-options\">3D Secure 2 with your existing Adyen integration<\/a>.<\/p>\n<div class=\"next-steps\" id=\"next-steps\" >\n<a href=\"\/online-payments\/classic-integrations\/classic-api-integration\/3d-secure-authentication\/3d-secure-1\" class=\"next-steps__step\" style=\"width:45%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Redirect<\/h6><p>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.<\/p><\/div><\/p><\/a><a href=\"\/online-payments\/classic-integrations\/classic-api-integration\/3d-secure-authentication\/native-3ds2\" class=\"next-steps__step\" style=\"width:45%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Native 3DS2 + Redirect 3DS1<\/h6><p>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.<\/p><\/div><\/p><\/a><\/div>\n\n<h2 id=\"3d-secure-2-implementation-options\">Implementing 3D Secure 2 with your existing Adyen integration<\/h2>\n<div class=\"sc-notice note\"><div>\n<p>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.<\/p>\n<\/div><\/div>\n<p>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.<\/p>\n<p><\/p>\n<p>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.<\/p>\n<table><thead><tr class=\"header\"><colgroup><col style=\"width: 40%\"><col style=\"width: 60%\"><\/colgroup><th>Your existing Adyen integration<\/th><th>What you need to do to support 3D Secure 2<\/th><\/tr><\/thead><tbody><tr><td>Online payments API, with existing 3D Secure 1 integration.<\/td><td>Do nothing. 3D Secure 2 will be supported through a redirect. <br><br>However, if you want a better shopper experience, <a href=\"\/online-payments\/3d-secure\/native-3ds2\">add 3D Secure 2 Components<\/a> or use<a href=\"\/online-payments\/drop-in-web\">Drop-in<\/a> on your client-side implementation.<\/td><\/tr><tr><td>Quick integration Checkout SDKs<\/td><td> Do nothing. 3D Secure 2 will be supported in Web, iOS, and Android SDKs through a redirect.<br><br>However, if you want a better shopper experience with native 3D Secure 2 authentication, switch to our <a href=\"\/online-payments\/drop-in-web\">Web<\/a>, <a href=\"\/online-payments\/ios\/drop-in\">iOS<\/a>, and <a href=\"\/online-payments\/android\/drop-in\">Android Drop-in<\/a> solution available from versions 3.0.0 and later.<br><br>If you want to continue using the mobile SDKs, you can upgrade to the following versions which support 3D Secure 2:<ul><li><a href=\"https:\/\/github.com\/Adyen\/adyen-android\/releases\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Checkout Android SDK version 2.4.0 to 2.4.5<\/a>.<\/li><li><a href=\"https:\/\/github.com\/Adyen\/adyen-ios\/releases\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Checkout iOS SDK version 2.6.0 to 2.8.4<\/a><\/li><\/ul><\/td><\/tr><tr><td>Plugins for Magento 1 and 2, PrestaShop, SFCC, or SAP Commerce (Hybris)<\/td><td>Upgrade to the following plugin versions to support native 3D Secure 2 authentication:<ul><li><a href=\"https:\/\/github.com\/Adyen\/adyen-magento2\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Magento 2 version 4.2.0 and later<\/a>.<\/li><li><a href=\"https:\/\/github.com\/Adyen\/adyen-salesforce-commerce-cloud\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Salesforce Commerce Cloud version 19.1.0 and later<\/a>.<\/li><li><a href=\"https:\/\/github.com\/Adyen\/adyen-hybris\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">SAP Commerce (Hybris) version 5.0.0 and later<\/a>.<\/li><li><a href=\"https:\/\/github.com\/Adyen\/adyen-prestashop\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">PrestaShop version 1.0.0 and later<\/a>.<\/li><\/ul><p> If you choose to continue using an older version of our plugins, we will support 3D Secure 2 through a redirect.<\/p><\/td><\/tr><tr><td>Hosted Payment Pages (HPP)<\/td><td>Do nothing. 3D Secure 2 will be supported through a redirect.<br><br>However, we strongly recommend to move your implementation to our <a href=\"\/online-payments\/drop-in-web\/\">online payments API<\/a> with the<a href=\"\/online-payments\/3d-secure\/native-3ds2\"> 3D Secure 2 Component<\/a> for a better user experience.<\/td><\/tr><tr><td>Classic integration or CSE, with existing 3D Secure 1 integration.<\/td><td>Do nothing. 3D Secure 2 will be supported through a redirect.<br><br>However, if you want a better shopper experience with native 3D Secure 2 authentication, use our <a href=\"\/online-payments\/classic-integrations\/classic-api-integration\/3d-secure-authentication\/native-3ds2\/browser-based-integration\/3d-secure-2-helper-functions\">helper functions<\/a> for web and the <a href=\"\/online-payments\/classic-integrations\/classic-api-integration\/3d-secure-authentication\/native-3ds2\/\">Classic integration 3D Secure 2 SDKs<\/a> for mobile.<\/td><\/tr><tr><td>Online payments API, without a 3D Secure 1 integration.<\/td><td>Integrate <a href=\"\/online-payments\/3d-secure\/redirect-3ds2\/\">3D Secure redirect authentication<\/a> to support both versions of 3D Secure or a combination of <a href=\"\/online-payments\/3d-secure\/native-3ds2\">3D Secure 2 native authentication<\/a> and a <a href=\"\/online-payments\/3d-secure\/redirect-3ds2-3ds1\/\">3D Secure 1 fallback.<\/a><\/td><\/tr><tr><td>Classic integration or CSE, without a 3D Secure 1 integration.<\/td><td>Integrate <a href=\"\/online-payments\/classic-integrations\/classic-api-integration\/3d-secure-authentication\/3d-secure-1\/\">3D Secure classic API redirect authentication<\/a> to support both versions of 3D Secure or a combination of <a href=\"\/online-payments\/classic-integrations\/classic-api-integration\/3d-secure-authentication\/native-3ds2\">3D Secure 2 native authentication<\/a> and a <a href=\"\/online-payments\/classic-integrations\/classic-api-integration\/3d-secure-authentication\/3d-secure-1\">3D Secure 1 fallback.<\/a><\/td><\/tr><\/tbody><\/table>\n<p>For guidelines on using 3D Secure with your current business model, see <a href=\"\/pt\/online-payments\/psd2-sca-compliance-and-implementation-guide\">PSD2 SCA compliance and implementation guide<\/a>.<\/p>","url":"https:\/\/docs.adyen.com\/pt\/online-payments\/classic-integrations\/classic-api-integration\/3d-secure-authentication","articleFields":{"description":"Explore your 3D Secure authentication options.","next_steps":[{"title":"PSD2 SCA compliance guide","description":"Understand how your business model can be PSD2 SCA-compliant with 3D Secure.","url":"\/online-payments\/psd2-sca-compliance-and-implementation-guide","required":false},{"title":"Classic API and 3D Secure 2","description":"Learn how you can implement 3D Secure 2 with your classic API integration.","url":"\/online-payments\/classic-integrations\/classic-api-integration\/3d-secure-authentication\/native-3ds2","required":false}],"section_icon":"classic-integration.svg","last_edit_on":"28-08-2019 16:26","parameters":{"anchor_new":"<a href=\/online-payments\/3d-secure>3D Secure on Checkout API<\/a>","parent_page":"Classic API (<code>\/authorise<\/code>)","new_desc":"integrating using our Checkout APIs"}},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/online-payments\/classic-integrations\/classic-api-integration\/3d-secure-authentication","title":"3D Secure authentication","content":"\nAdyen is no longer developing the Classic API integration\nThis page is for the Classic API (\/authorise) integration, which we no longer accept new integrations with. \nWe strongly recommend migrating to the newer 3D Secure on Checkout API integration. To use this newer integration, you must also migrate to the Checkout API.\n\n3D 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:\n\nComply with authentication regulations for online payments, such as PSD2 SCA.\nAvail of the liability shift. When a transaction has been authenticated through 3D Secure, the liability for fraudulent chargebacks shifts from you to the issuing bank.\n\n\nIf you have an existing integration with Adyen, see the section on adding 3D Secure to your Adyen integration.\n\nUnderstanding 3D Secure versions\n3D Secure has two available versions:\n\n3D 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.\n3D 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.\n\nUntil 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.\nYour 3D Secure implementation options\nWe provide the following options to support both 3D Secure versions with your API integration:\n\n\nRedirect 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.\n\n\nNative 3DS2 + Redirect 3DS1: Use our 3D Secure 2 helper functions for Web and SDKs for iOS and Android 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 authentication, you should handle the redirect on your client-side implementation.\n\n\nClick 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.\n\nRedirectSupport 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.Native 3DS2 + Redirect 3DS1Support 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.\n\nImplementing 3D Secure 2 with your existing Adyen integration\n\nIf 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.\n\nIf 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.\n\nIn 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.\nYour existing Adyen integrationWhat you need to do to support 3D Secure 2Online 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 or useDrop-in 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, iOS, and 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.Checkout iOS SDK version 2.6.0 to 2.8.4Plugins 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.Salesforce Commerce Cloud version 19.1.0 and later.SAP Commerce (Hybris) version 5.0.0 and later.PrestaShop version 1.0.0 and later. 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 with the 3D Secure 2 Component 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 for web and the Classic integration 3D Secure 2 SDKs for mobile.Online payments API, without a 3D Secure 1 integration.Integrate 3D Secure redirect authentication to support both versions of 3D Secure or a combination of 3D Secure 2 native authentication and a 3D Secure 1 fallback.Classic integration or CSE, without a 3D Secure 1 integration.Integrate 3D Secure classic API redirect authentication to support both versions of 3D Secure or a combination of 3D Secure 2 native authentication and a 3D Secure 1 fallback.\nFor guidelines on using 3D Secure with your current business model, see PSD2 SCA compliance and implementation guide.","type":"page","locale":"pt","boost":16,"hierarchy":{"lvl0":"Home","lvl1":"Online payments","lvl2":"Classic integrations for Ecommerce","lvl3":"Classic API integration","lvl4":"3D Secure authentication"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/online-payments","lvl2":"https:\/\/docs.adyen.com\/pt\/online-payments\/classic-integrations","lvl3":"https:\/\/docs.adyen.com\/pt\/online-payments\/classic-integrations\/classic-api-integration","lvl4":"\/pt\/online-payments\/classic-integrations\/classic-api-integration\/3d-secure-authentication"},"levels":5,"category":"Online Payments","category_color":"green","tags":["Secure","authentication"]}}