{"title":"Upgrade your integration","category":"default","creationDate":1724751360,"content":"<div class=\"additional-info-block output-inline\">\n<h5 class=\"article__heading additional-info-block__title\">Find our latest releases<\/h5><div class=\"additional-info-block__body\"><p>&nbsp;<i class=\"adl-icon-adyen\" role=\"img\" aria-label=\"adyen icon\"><\/i>&nbsp;<a href=\"\/pt\/online-payments\/release-notes\">Release notes<\/a><br \/><img alt=\"\" src=\"\/user\/pages\/docs\/02.online-payments\/04.upgrade-your-integration\/github-icon.png\" \/>&nbsp;<a href=\"https:\/\/github.com\/Adyen\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Adyen on Github<\/a><\/p><\/div><\/div>\n\n<p>Adyen aims to offer seamless integration for an easy checkout and payment process to shoppers globally. Because the payments industry is constantly changing, we frequently release new versions and features.<\/p>\n<p>We recommend that you upgrade your integration regularly to benefit from our latest improvements. Our updates provide competitive advantages so that your shoppers have an efficient checkout experience.<\/p>\n<p>We frequently release improvements to our products to keep up with the newest developments in the fast-paced payments industry:<\/p>\n<ul>\n<li>Shopper expectations<\/li>\n<li>Regulations<\/li>\n<li>Best practices<\/li>\n<\/ul>\n<h2>Our way of versioning<\/h2>\n<p>Check our <a href=\"\/pt\/online-payments\/release-notes\">release notes<\/a> to see the latest changes and follow our <a href=\"#upgrade-guides\">upgrade guides<\/a> to upgrade your integration.<\/p>\n<table>\n<thead>\n<tr>\n<th>Type of changes<\/th>\n<th>Version type<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><strong>Backwards-compatible<\/strong><\/td>\n<td>Minor version<\/td>\n<td>The changes in these versions work with earlier versions and do not break existing integrations.<\/td>\n<\/tr>\n<tr>\n<td><strong>Breaking changes<\/strong><\/td>\n<td>Major version<\/td>\n<td>We only introduce changes that do not work with earlier versions in major versions. For example, these could be new features or new ways of structuring data present in earlier versions.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>For our <a href=\"https:\/\/github.com\/adyen#client-side\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Drop-in\/Components<\/a>, we frequently release minor versions and periodically release major versions.<br \/>\nFor our  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/overview\" class=\" external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Checkout API<\/a>, we only release major versions.<\/p>\n<h3 id=\"lifecycle\">Drop-in\/Components lifecycle<\/h3>\n<p>After a new Drop-in\/Components version is released, it follows a lifecycle that contains four states.<\/p>\n<table>\n<thead>\n<tr>\n<th>State<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><strong>Active<\/strong><\/td>\n<td>The latest major version of Drop-in\/Components. This is the recommended version to use that benefits from new features, bug fixes, and changes required to comply with new regulations.<\/td>\n<\/tr>\n<tr>\n<td><strong>Inactive<\/strong><\/td>\n<td>A version that only receives bug fixes and changes required to comply with new regulations.<\/td>\n<\/tr>\n<tr>\n<td><strong>Deprecated<\/strong><\/td>\n<td>A version that no longer receives any new features, bug fixes, and changes required to comply with new regulations. After a version reaches this state, you have 1 year to upgrade to the latest version of Drop-in\/Components.<\/td>\n<td><\/td>\n<\/tr>\n<tr>\n<td><strong>End-of-Life<\/strong><\/td>\n<td>A version that no longer receives any new features, bug fixes, and changes required to comply with new regulations. When a version reaches end-of-life, you no longer receive support from Adyen and payment processing can be suspended anytime.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Check the lifecycle states of our Drop-in\/Components versions per platform on GitHub:<\/p>\n<ul>\n<li><a href=\"https:\/\/github.com\/Adyen\/adyen-web?tab=readme-ov-file#drop-incomponents-lifecycle\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Web<\/a><\/li>\n<li><a href=\"https:\/\/github.com\/Adyen\/adyen-ios?tab=readme-ov-file#sdk-lifecycle\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">iOS<\/a><\/li>\n<li><a href=\"https:\/\/github.com\/Adyen\/adyen-android?tab=readme-ov-file#drop-incomponents-lifecycle\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Android<\/a><\/li>\n<\/ul>\n<div class=\"sc-notice note\"><div>\n<p>We deprecate older versions to protect your data and maintain compliance with financial regulations. <br> Check your version's lifecycle state to plan your upgrade.<\/p>\n<\/div><\/div>\n<p>The following is a visual example of how different versions receive new states over time:<\/p>\n<p><img style=\"width: 800px;\" alt=\"\" src=\"\/user\/pages\/docs\/02.online-payments\/04.upgrade-your-integration\/lifecycle.svg?decoding=auto&amp;fetchpriority=auto\" \/><\/p>\n<h2>Staying up-to-date<\/h2>\n<p>You can get the best of Adyen's products when you upgrade your existing integration to a newer version. We recommend the following:<\/p>\n<h3>Upgrade to the latest version of Drop-in\/Components<\/h3>\n<p>Maintaining the latest version of Drop-in\/Components is crucial for new features, security updates, and compliance. To stay current and ensure compatibility, <a href=\"https:\/\/docs.github.com\/en\/account-and-profile\/managing-subscriptions-and-notifications-on-github\/setting-up-notifications\/configuring-notifications#configuring-your-watch-settings-for-an-individual-repository\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">watch<\/a> the <a href=\"https:\/\/github.com\/Adyen\/adyen-web\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">adyen-web GitHub repository<\/a> and select <strong>Custom<\/strong> &gt; <strong>Releases<\/strong>.<\/p>\n<p>Drop-in\/Components follow the <a href=\"https:\/\/semver.org\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">semantic versioning<\/a> standard. Changes are released in a new patch, minor, or major version.<\/p>\n<p>We recommend you upgrade to the latest major version of Drop-in\/Components to get the latest features and bug fixes. The breaking changes introduced in our major versions improve performance of the integration and developer experience. Adyen no longer upgrades earlier major versions.<\/p>\n<p>When you upgrade to the latest major version, you get the following:<\/p>\n<ul>\n<li>New payment methods<\/li>\n<li>New accessibility features<\/li>\n<li>Design improvements<\/li>\n<li>Better technical support<\/li>\n<\/ul>\n<p>Before upgrading to a new major version of Drop-in\/Components, read the <a href=\"https:\/\/docs.adyen.com\/online-payments\/release-notes\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">release notes<\/a> to check the minimum required Checkout API version.<\/p>\n<h3>Upgrade to the latest version of Checkout API<\/h3>\n<p>If you use Checkout API, we recommend that you upgrade to the latest version of Checkout API if the following applies to you:<\/p>\n<ul>\n<li>You use 3D Secure 2 to authenticate payments with Adyen and use v66 or earlier.  In v67, we simplified the integration and introduced auto-authorization that reduces integration errors and failed payments.<\/li>\n<li>You are are upgrading Drop-in\/Components to a version that is no longer compatible with the your current Checkout API version. For example, <a href=\"\/pt\/online-payments\/release-notes\/?title%5B0%5D=Web%20Components%2FDrop-in&amp;version%5B0%5D=5.0.0\">Web Drop-in\/Components v5.0.0<\/a> is only compatible with <a href=\"\/pt\/online-payments\/release-notes\/?title%5B0%5D=Checkout%20API&amp;version%5B0%5D=68\">Checkout API v68<\/a> or later.<\/li>\n<\/ul>\n<p>We continuously release new features for Checkout API to improve your online payments integration. Most improvements are backward compatible. When we must introduce a breaking change, we release a new major version.<\/p>\n<p>Explore the latest updates to our Checkout API in the <a href=\"\/pt\/online-payments\/release-notes\/?title%5B0%5D=Checkout%2BAPI\">release notes<\/a>.<\/p>\n<h3>Migrate from Classic API to Checkout API<\/h3>\n<p>We no longer develop the <a href=\"\/pt\/online-payments\/classic-integrations\/classic-api-integration\">Classic API<\/a>, which can process only card payments.<\/p>\n<p>We strongly recommend that you migrate your <a href=\"\/pt\/online-payments\/build-your-integration\">server-side integration<\/a> to use the latest version of the Checkout API for the following benefits:<\/p>\n<ul>\n<li>A single integration to process all payment methods, including cards, bank-based, and alternative payment methods.<\/li>\n<li>A simpler client-side integration with Drop-in\/Components that is only available with the Checkout API.<\/li>\n<li>Improved 3D Secure 2 authentication for payments. This includes simpler integration and the auto-authorization feature which reduces integration errors and failed payments.<\/li>\n<li>An integration that adheres to latest security standards, like <a href=\"https:\/\/en.wikipedia.org\/wiki\/JSON_Web_Encryption\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">JSON Web Encryption (JWE)<\/a> and <a href=\"https:\/\/en.wikipedia.org\/wiki\/JSON_Web_Signature\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">JSON Web Signature (JWS)<\/a>, and offers your shoppers a more secure checkout process.<\/li>\n<li>A simple, developer-friendly integration experience that handles many of the complexities of processing payments with less code complexity.<\/li>\n<li>More specific error responses that makes debugging easier.<\/li>\n<\/ul>\n<h2>Upgrade guides<\/h2>\n<p>We have guides to help you upgrade to the following:<\/p>\n<h3>Checkout API<\/h3>\n<table>\n<thead>\n<tr>\n<th>Upgrade guide<\/th>\n<th>From version<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><a href=\"\/pt\/online-payments\/upgrade-your-integration\/migrate-to-checkout-api\">Migrate to Checkout API (latest version)<\/a><\/td>\n<td>Classic API<\/td>\n<\/tr>\n<tr>\n<td><a href=\"\/pt\/online-payments\/upgrade-your-integration\/upgrade-to-checkout-api-v72\">Upgrade to Checkout API v72<\/a><\/td>\n<td>v70 or v71<\/td>\n<\/tr>\n<tr>\n<td><a href=\"\/pt\/online-payments\/upgrade-your-integration\/upgrade-to-checkout-api-v70\">Upgrade to Checkout API v70<\/a><\/td>\n<td>v69<\/td>\n<\/tr>\n<tr>\n<td><a href=\"\/pt\/online-payments\/upgrade-your-integration\/upgrade-to-checkout-api-v69\">Upgrade to Checkout API v69<\/a><\/td>\n<td>v68<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3>Drop-in\/Components<\/h3>\n\n<div id=\"tabMe4d3\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Web&quot;,&quot;content&quot;:&quot;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th&gt;Upgrade guide&lt;\\\/th&gt;\\n&lt;th&gt;From version&lt;\\\/th&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;a href=\\&quot;\\\/pt\\\/online-payments\\\/upgrade-your-integration\\\/upgrade-to-web-v6\\&quot;&gt;Upgrade to v6.0.0&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td&gt;v5.x.x&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;a href=\\&quot;\\\/pt\\\/online-payments\\\/upgrade-your-integration\\\/upgrade-to-web-v6\\\/from-v4\\&quot;&gt;Upgrade to v6.0.0&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td&gt;v4.x.x&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;a href=\\&quot;\\\/pt\\\/online-payments\\\/upgrade-your-integration\\\/upgrade-to-web-v6\\\/from-v3\\&quot;&gt;Upgrade to v6.0.0&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td&gt;v3.x.x&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/tbody&gt;\\n&lt;\\\/table&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;web_0_1&quot;,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;iOS&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;When you choose a version to upgrade to, make sure that it is &lt;a href=\\&quot;#ios\\&quot;&gt;compatible with the versions&lt;\\\/a&gt; of other parts of your integration.&lt;\\\/p&gt;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th&gt;Upgrade guide&lt;\\\/th&gt;\\n&lt;th&gt;From version&lt;\\\/th&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;a href=\\&quot;\\\/pt\\\/online-payments\\\/upgrade-your-integration\\\/upgrade-to-ios-5-0-0\\&quot;&gt;Upgrade to v5.0.0&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td&gt;v4.x.x&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;a href=\\&quot;\\\/pt\\\/online-payments\\\/upgrade-your-integration\\\/upgrade-to-ios-4-0-0\\&quot;&gt;Upgrade to v4.0.0&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td&gt;v3.x.x&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/tbody&gt;\\n&lt;\\\/table&gt;\\n&quot;,&quot;altTitle&quot;:&quot;ios&quot;,&quot;oldTabId&quot;:&quot;ios-migration_2&quot;,&quot;relation&quot;:&quot;ios&quot;},{&quot;title&quot;:&quot;Android&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;When you choose a version to upgrade to, make sure that it is &lt;a href=\\&quot;#android\\&quot;&gt;compatible with the versions&lt;\\\/a&gt; of other parts of your integration.&lt;\\\/p&gt;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th&gt;Upgrade guide&lt;\\\/th&gt;\\n&lt;th&gt;From version&lt;\\\/th&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;a href=\\&quot;\\\/pt\\\/online-payments\\\/upgrade-your-integration\\\/upgrade-to-android-5-0-0\\&quot;&gt;Upgrade to v5.0.0&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td&gt;v4.x.x&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;a href=\\&quot;\\\/pt\\\/online-payments\\\/upgrade-your-integration\\\/upgrade-to-android-4-0-0\\&quot;&gt;Upgrade to v4.0.0&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td&gt;v3.x.x&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/tbody&gt;\\n&lt;\\\/table&gt;\\n&quot;,&quot;altTitle&quot;:&quot;android&quot;,&quot;oldTabId&quot;:&quot;android-migration_3&quot;,&quot;relation&quot;:&quot;android&quot;}]\"\n            :should-update-when-url-changes='true'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<h2>Drop-in\/Components version compatibility<\/h2>\n<p>Each version of iOS and Android Drop-in\/Components is compatible with different versions of other parts of your integration. When you upgrade, you must use versions that are compatible with one another.<\/p>\n<div class=\"accordion-shortcode adl-accordion adl-accordion--max-height-transition\" data-expand=\"true\" data-ignore=\"anchorjs-link\">\n    \n    <div class=\"adl-accordion__item\" style=\"\">\n        <div tabindex=\"0\" role=\"item\" aria-expanded=\"false\" class=\"adl-accordion__header\">\n            <i class=\"adl-accordion__toggle adl-icon-chevron-down\"><\/i>\n            <div class=\"adl-accordion__title-wrapper\" data-accordion=\"#i-os\">\n                                    <h3 class=\"adl-accordion__title\">iOS<\/h3>\n                            <\/div>\n        <\/div>\n        <div role=\"region\" class=\"adl-accordion__content\">\n            \n<p>For iOS Drop-in\/Components, you must make sure your version of Drop-in\/Components is compatible with the following:<\/p>\n<table>\n<thead>\n<tr>\n<th><\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Checkout API<\/td>\n<td>The recommended earliest version of Checkout API.<\/td>\n<\/tr>\n<tr>\n<td>iOS version<\/td>\n<td>The earliest version of iOS that is compatible.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>The iOS compatibility table shows these for each version of Drop-in\/Components.<\/p>\n<p>For example, if you use Drop-in\/Components v5.13.0, you must use Checkout API v71 and iOS v12.<\/p>\n<h3 id=\"ios-compatibility-table\">iOS compatibility table<\/h3>\n<table>\n<thead>\n<tr>\n<th>Drop-in\/Components<\/th>\n<th>Checkout API<\/th>\n<th>iOS version<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>5.5.0 - 5.13.0<\/td>\n<td>v71<\/td>\n<td>12<\/td>\n<\/tr>\n<tr>\n<td>5.4.0 - 5.4.1<\/td>\n<td>v70<\/td>\n<td>12<\/td>\n<\/tr>\n<tr>\n<td>5.2.0 - 5.3.0<\/td>\n<td>v70<\/td>\n<td>11, if you use <a href=\"https:\/\/developer.apple.com\/documentation\/Xcode-Release-Notes#Xcode-14\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Xcode 14<\/a> or earlier. <br> 12, if you use <a href=\"https:\/\/developer.apple.com\/documentation\/Xcode-Release-Notes#Xcode-15\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Xcode 15<\/a> or later.<\/td>\n<\/tr>\n<tr>\n<td>5.0.0 - 5.1.0<\/td>\n<td>v69<\/td>\n<td>11, if you use <a href=\"https:\/\/developer.apple.com\/documentation\/Xcode-Release-Notes#Xcode-14\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Xcode 14<\/a> or earlier. <br> 12, if you use <a href=\"https:\/\/developer.apple.com\/documentation\/Xcode-Release-Notes#Xcode-15\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Xcode 15<\/a> or later.<\/td>\n<\/tr>\n<tr>\n<td>4.12.0 - 4.14.0<\/td>\n<td>v71<\/td>\n<td>12<\/td>\n<\/tr>\n<tr>\n<td>4.11.1 - 4.11.2<\/td>\n<td>v70<\/td>\n<td>12<\/td>\n<\/tr>\n<tr>\n<td>4.10.4 - 4.11.0<\/td>\n<td>v70<\/td>\n<td>11, if you use <a href=\"https:\/\/developer.apple.com\/documentation\/Xcode-Release-Notes#Xcode-14\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Xcode 14<\/a> or earlier. <br> 12, if you use <a href=\"https:\/\/developer.apple.com\/documentation\/Xcode-Release-Notes#Xcode-15\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Xcode 15<\/a> or later.<\/td>\n<\/tr>\n<tr>\n<td>4.10.2 - 4.10.3<\/td>\n<td>v69<\/td>\n<td>11, if you use <a href=\"https:\/\/developer.apple.com\/documentation\/Xcode-Release-Notes#Xcode-14\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Xcode 14<\/a> or earlier. <br> 12, if you use <a href=\"https:\/\/developer.apple.com\/documentation\/Xcode-Release-Notes#Xcode-15\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Xcode 15<\/a> or later.<\/td>\n<\/tr>\n<tr>\n<td>4.0.0 - 4.10.1<\/td>\n<td>v67<\/td>\n<td>11, if you use <a href=\"https:\/\/developer.apple.com\/documentation\/Xcode-Release-Notes#Xcode-14\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Xcode 14<\/a> or earlier. <br> 12, if you use <a href=\"https:\/\/developer.apple.com\/documentation\/Xcode-Release-Notes#Xcode-15\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Xcode 15<\/a> or later.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n        <\/div>\n    <\/div>\n<\/div>\n\n<div class=\"accordion-shortcode adl-accordion adl-accordion--max-height-transition\" data-expand=\"true\" data-ignore=\"anchorjs-link\">\n    \n    <div class=\"adl-accordion__item\" style=\"\">\n        <div tabindex=\"0\" role=\"item\" aria-expanded=\"false\" class=\"adl-accordion__header\">\n            <i class=\"adl-accordion__toggle adl-icon-chevron-down\"><\/i>\n            <div class=\"adl-accordion__title-wrapper\" data-accordion=\"#android\">\n                                    <h3 class=\"adl-accordion__title\">Android<\/h3>\n                            <\/div>\n        <\/div>\n        <div role=\"region\" class=\"adl-accordion__content\">\n            \n<p>For Android Drop-in\/Components, you must make sure your version of Drop-in\/Components is compatible with the following:<\/p>\n<table>\n<thead>\n<tr>\n<th><\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Checkout API<\/td>\n<td>The recommended earliest version of Checkout API.<\/td>\n<\/tr>\n<tr>\n<td>Minimum SDK version<\/td>\n<td>The <a href=\"https:\/\/developer.android.com\/guide\/topics\/manifest\/uses-sdk-element#apilevel\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">minimum SDK version<\/a>. <br> In your <a href=\"https:\/\/developer.android.com\/guide\/topics\/manifest\/manifest-intro\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">manifest file<\/a> as the <code>minSdkVersion<\/code> or in your <a href=\"https:\/\/developer.android.com\/build#module-level\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">build configuration<\/a> as <code>minSdk<\/code>.<\/td>\n<\/tr>\n<tr>\n<td>Target SDK version<\/td>\n<td>The <a href=\"https:\/\/developer.android.com\/google\/play\/requirements\/target-sdk\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">target SDK version<\/a>. <br> In your <a href=\"https:\/\/developer.android.com\/guide\/topics\/manifest\/manifest-intro\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">manifest file<\/a> as the <code>targetSdkVersion<\/code> or in your <a href=\"https:\/\/developer.android.com\/build#module-level\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">build configuration<\/a> as <code>targetSdk<\/code>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>The Android compatibility table shows these for each version of Drop-in\/Components.<\/p>\n<p>For example, if you use Drop-in\/Components v5.7.0, you must use Checkout API v71, minimum API level 21, and target API level 34.<\/p>\n<h3 id=\"android-compatibility-table\">Android compatibility table<\/h3>\n<table>\n<thead>\n<tr>\n<th>Drop-in\/Components<\/th>\n<th>Checkout API<\/th>\n<th>Minimum SDK version<\/th>\n<th>Target SDK version<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>5.9.1 - latest<\/td>\n<td>v71<\/td>\n<td>21<\/td>\n<td>35<\/td>\n<\/tr>\n<tr>\n<td>5.1.0 - 5.9.0<\/td>\n<td>v71<\/td>\n<td>21<\/td>\n<td>34<\/td>\n<\/tr>\n<tr>\n<td>5.0.0 - 5.0.1<\/td>\n<td>v70<\/td>\n<td>21<\/td>\n<td>34<\/td>\n<\/tr>\n<tr>\n<td>4.13.0 - 4.13.6<\/td>\n<td>v70<\/td>\n<td>21<\/td>\n<td>33<\/td>\n<\/tr>\n<tr>\n<td>4.11.0 - 4.12.1<\/td>\n<td>v70<\/td>\n<td>21<\/td>\n<td>32<\/td>\n<\/tr>\n<tr>\n<td>4.10.0<\/td>\n<td>v69<\/td>\n<td>21<\/td>\n<td>32<\/td>\n<\/tr>\n<tr>\n<td>4.9.0 - 4.9.1<\/td>\n<td>v69<\/td>\n<td>21<\/td>\n<td>31<\/td>\n<\/tr>\n<tr>\n<td>4.0.0 - 4.8.0<\/td>\n<td>v67<\/td>\n<td>21<\/td>\n<td>30<\/td>\n<\/tr>\n<tr>\n<td>3.8.0 - 3.8.3<\/td>\n<td>v52<\/td>\n<td>16<\/td>\n<td>28<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n        <\/div>\n    <\/div>\n<\/div>\n\n<h2 id=\"see-also\">See also<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/online-payments\/release-notes\"\n                        target=\"_self\"\n                        >\n                    Release notes\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/online-payments\/upgrade-your-integration","articleFields":{"description":"Keep your integration up-to-date with the latest versions.","feedback_component":true,"filters_component":false,"decision_tree":"[]","page_id":"ddbec4e7-0df5-4e2a-9fec-134a5cd8ca83","last_edit_on":"06-03-2025 12:03"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/online-payments\/upgrade-your-integration","title":"Upgrade your integration","content":"\nFind our latest releases&nbsp;&nbsp;Release notes&nbsp;Adyen on Github\n\nAdyen aims to offer seamless integration for an easy checkout and payment process to shoppers globally. Because the payments industry is constantly changing, we frequently release new versions and features.\nWe recommend that you upgrade your integration regularly to benefit from our latest improvements. Our updates provide competitive advantages so that your shoppers have an efficient checkout experience.\nWe frequently release improvements to our products to keep up with the newest developments in the fast-paced payments industry:\n\nShopper expectations\nRegulations\nBest practices\n\nOur way of versioning\nCheck our release notes to see the latest changes and follow our upgrade guides to upgrade your integration.\n\n\n\nType of changes\nVersion type\nDescription\n\n\n\n\nBackwards-compatible\nMinor version\nThe changes in these versions work with earlier versions and do not break existing integrations.\n\n\nBreaking changes\nMajor version\nWe only introduce changes that do not work with earlier versions in major versions. For example, these could be new features or new ways of structuring data present in earlier versions.\n\n\n\nFor our Drop-in\/Components, we frequently release minor versions and periodically release major versions.\nFor our  Checkout API, we only release major versions.\nDrop-in\/Components lifecycle\nAfter a new Drop-in\/Components version is released, it follows a lifecycle that contains four states.\n\n\n\nState\nDescription\n\n\n\n\nActive\nThe latest major version of Drop-in\/Components. This is the recommended version to use that benefits from new features, bug fixes, and changes required to comply with new regulations.\n\n\nInactive\nA version that only receives bug fixes and changes required to comply with new regulations.\n\n\nDeprecated\nA version that no longer receives any new features, bug fixes, and changes required to comply with new regulations. After a version reaches this state, you have 1 year to upgrade to the latest version of Drop-in\/Components.\n\n\n\nEnd-of-Life\nA version that no longer receives any new features, bug fixes, and changes required to comply with new regulations. When a version reaches end-of-life, you no longer receive support from Adyen and payment processing can be suspended anytime.\n\n\n\nCheck the lifecycle states of our Drop-in\/Components versions per platform on GitHub:\n\nWeb\niOS\nAndroid\n\n\nWe deprecate older versions to protect your data and maintain compliance with financial regulations.  Check your version's lifecycle state to plan your upgrade.\n\nThe following is a visual example of how different versions receive new states over time:\n\nStaying up-to-date\nYou can get the best of Adyen's products when you upgrade your existing integration to a newer version. We recommend the following:\nUpgrade to the latest version of Drop-in\/Components\nMaintaining the latest version of Drop-in\/Components is crucial for new features, security updates, and compliance. To stay current and ensure compatibility, watch the adyen-web GitHub repository and select Custom &gt; Releases.\nDrop-in\/Components follow the semantic versioning standard. Changes are released in a new patch, minor, or major version.\nWe recommend you upgrade to the latest major version of Drop-in\/Components to get the latest features and bug fixes. The breaking changes introduced in our major versions improve performance of the integration and developer experience. Adyen no longer upgrades earlier major versions.\nWhen you upgrade to the latest major version, you get the following:\n\nNew payment methods\nNew accessibility features\nDesign improvements\nBetter technical support\n\nBefore upgrading to a new major version of Drop-in\/Components, read the release notes to check the minimum required Checkout API version.\nUpgrade to the latest version of Checkout API\nIf you use Checkout API, we recommend that you upgrade to the latest version of Checkout API if the following applies to you:\n\nYou use 3D Secure 2 to authenticate payments with Adyen and use v66 or earlier.  In v67, we simplified the integration and introduced auto-authorization that reduces integration errors and failed payments.\nYou are are upgrading Drop-in\/Components to a version that is no longer compatible with the your current Checkout API version. For example, Web Drop-in\/Components v5.0.0 is only compatible with Checkout API v68 or later.\n\nWe continuously release new features for Checkout API to improve your online payments integration. Most improvements are backward compatible. When we must introduce a breaking change, we release a new major version.\nExplore the latest updates to our Checkout API in the release notes.\nMigrate from Classic API to Checkout API\nWe no longer develop the Classic API, which can process only card payments.\nWe strongly recommend that you migrate your server-side integration to use the latest version of the Checkout API for the following benefits:\n\nA single integration to process all payment methods, including cards, bank-based, and alternative payment methods.\nA simpler client-side integration with Drop-in\/Components that is only available with the Checkout API.\nImproved 3D Secure 2 authentication for payments. This includes simpler integration and the auto-authorization feature which reduces integration errors and failed payments.\nAn integration that adheres to latest security standards, like JSON Web Encryption (JWE) and JSON Web Signature (JWS), and offers your shoppers a more secure checkout process.\nA simple, developer-friendly integration experience that handles many of the complexities of processing payments with less code complexity.\nMore specific error responses that makes debugging easier.\n\nUpgrade guides\nWe have guides to help you upgrade to the following:\nCheckout API\n\n\n\nUpgrade guide\nFrom version\n\n\n\n\nMigrate to Checkout API (latest version)\nClassic API\n\n\nUpgrade to Checkout API v72\nv70 or v71\n\n\nUpgrade to Checkout API v70\nv69\n\n\nUpgrade to Checkout API v69\nv68\n\n\n\nDrop-in\/Components\n\n\n    \n        \n        \n    \n\n\nDrop-in\/Components version compatibility\nEach version of iOS and Android Drop-in\/Components is compatible with different versions of other parts of your integration. When you upgrade, you must use versions that are compatible with one another.\n\n    \n    \n        \n            \n            \n                                    iOS\n                            \n        \n        \n            \nFor iOS Drop-in\/Components, you must make sure your version of Drop-in\/Components is compatible with the following:\n\n\n\n\nDescription\n\n\n\n\nCheckout API\nThe recommended earliest version of Checkout API.\n\n\niOS version\nThe earliest version of iOS that is compatible.\n\n\n\nThe iOS compatibility table shows these for each version of Drop-in\/Components.\nFor example, if you use Drop-in\/Components v5.13.0, you must use Checkout API v71 and iOS v12.\niOS compatibility table\n\n\n\nDrop-in\/Components\nCheckout API\niOS version\n\n\n\n\n5.5.0 - 5.13.0\nv71\n12\n\n\n5.4.0 - 5.4.1\nv70\n12\n\n\n5.2.0 - 5.3.0\nv70\n11, if you use Xcode 14 or earlier.  12, if you use Xcode 15 or later.\n\n\n5.0.0 - 5.1.0\nv69\n11, if you use Xcode 14 or earlier.  12, if you use Xcode 15 or later.\n\n\n4.12.0 - 4.14.0\nv71\n12\n\n\n4.11.1 - 4.11.2\nv70\n12\n\n\n4.10.4 - 4.11.0\nv70\n11, if you use Xcode 14 or earlier.  12, if you use Xcode 15 or later.\n\n\n4.10.2 - 4.10.3\nv69\n11, if you use Xcode 14 or earlier.  12, if you use Xcode 15 or later.\n\n\n4.0.0 - 4.10.1\nv67\n11, if you use Xcode 14 or earlier.  12, if you use Xcode 15 or later.\n\n\n\n\n        \n    \n\n\n\n    \n    \n        \n            \n            \n                                    Android\n                            \n        \n        \n            \nFor Android Drop-in\/Components, you must make sure your version of Drop-in\/Components is compatible with the following:\n\n\n\n\nDescription\n\n\n\n\nCheckout API\nThe recommended earliest version of Checkout API.\n\n\nMinimum SDK version\nThe minimum SDK version.  In your manifest file as the minSdkVersion or in your build configuration as minSdk.\n\n\nTarget SDK version\nThe target SDK version.  In your manifest file as the targetSdkVersion or in your build configuration as targetSdk.\n\n\n\nThe Android compatibility table shows these for each version of Drop-in\/Components.\nFor example, if you use Drop-in\/Components v5.7.0, you must use Checkout API v71, minimum API level 21, and target API level 34.\nAndroid compatibility table\n\n\n\nDrop-in\/Components\nCheckout API\nMinimum SDK version\nTarget SDK version\n\n\n\n\n5.9.1 - latest\nv71\n21\n35\n\n\n5.1.0 - 5.9.0\nv71\n21\n34\n\n\n5.0.0 - 5.0.1\nv70\n21\n34\n\n\n4.13.0 - 4.13.6\nv70\n21\n33\n\n\n4.11.0 - 4.12.1\nv70\n21\n32\n\n\n4.10.0\nv69\n21\n32\n\n\n4.9.0 - 4.9.1\nv69\n21\n31\n\n\n4.0.0 - 4.8.0\nv67\n21\n30\n\n\n3.8.0 - 3.8.3\nv52\n16\n28\n\n\n\n\n        \n    \n\n\nSee also\n\n\n                    Release notes\n                \n","type":"page","locale":"pt","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Online payments","lvl2":"Upgrade your integration"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/online-payments","lvl2":"\/pt\/online-payments\/upgrade-your-integration"},"levels":3,"category":"Online Payments","category_color":"green","tags":["Upgrade","integration"]},"articleFiles":{"github-icon.png":"<img alt=\"\" src=\"https:\/\/docs.adyen.com\/user\/pages\/docs\/02.online-payments\/04.upgrade-your-integration\/github-icon.png\" \/>","lifecycle.svg":"<img style=\"width: 800px;\" alt=\"\" src=\"https:\/\/docs.adyen.com\/user\/pages\/docs\/02.online-payments\/04.upgrade-your-integration\/lifecycle.svg?decoding=auto&amp;fetchpriority=auto\" \/>"}}