{"title":"Migrate to a new version","category":"default","creationDate":1703170980,"content":"<p>On this page, we describe the changes that you need to make in your existing integration when migrating to a later version of the Adobe Commerce plugin.<\/p>\n\n<div id=\"tabDkNpx\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Migrate to version 10&quot;,&quot;content&quot;:&quot;\\n&lt;h2&gt;Step 1: Upgrade Adobe Commerce and PHP&lt;\\\/h2&gt;\\n&lt;p&gt;Version 10 of the plugin supports PHP 8.2 and later, and Adobe Commerce 2.4.8. We no longer support Adobe Commerce 2.4.7 or earlier due to the backward incompatible changes introduced in later versions.&lt;\\\/p&gt;\\n&lt;p&gt;If you are on an earlier version, upgrade your &lt;a href=\\&quot;https:\\\/\\\/experienceleague.adobe.com\\\/en\\\/docs\\\/commerce-operations\\\/release\\\/notes\\\/magento-open-source\\\/2-4-8\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Adobe Commerce&lt;\\\/a&gt; and &lt;a href=\\&quot;https:\\\/\\\/www.php.net\\\/manual\\\/en\\\/migration82.php\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;PHP version&lt;\\\/a&gt; before you upgrade the plugin.&lt;\\\/p&gt;\\n&lt;h2 id=\\&quot;upgrade-to-version-10\\&quot;&gt;Step 2: Upgrade the plugin&lt;\\\/h2&gt;\\n&lt;p&gt;Follow the &lt;a href=\\&quot;\\\/pt\\\/plugins\\\/adobe-commerce\\\/upgrade\\&quot;&gt;instructions to upgrade the plugin&lt;\\\/a&gt; to version 10.&lt;\\\/p&gt;\\n&lt;h2 id=\\&quot;check-dependencies-version-10\\&quot;&gt;Step 3: Check dependencies&lt;\\\/h2&gt;\\n&lt;p&gt;Version 10 of the plugin uses:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;&lt;a href=\\&quot;\\\/pt\\\/online-payments\\\/release-notes?integration_type=api&amp;amp;version=71\\&quot;&gt;Checkout API version 71&lt;\\\/a&gt;: if you have customized the plugin logic, upgrading could cause issues in the implementation of your custom code. Check if your integration is compatible with the new version of Checkout API.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;a href=\\&quot;\\\/pt\\\/online-payments\\\/release-notes\\\/?integration_type=web&amp;amp;version=6.13.1\\&quot;&gt;Web Components version 6.13.1&lt;\\\/a&gt;: Web Components v6 introduces various changes. If you applied any customizations to our Components, or have a &lt;a href=\\&quot;\\\/pt\\\/plugins\\\/adobe-commerce\\\/headless-integration\\&quot;&gt;headless integration&lt;\\\/a&gt;, review the changes to make sure your integration is compatible. Refer to our &lt;a href=\\&quot;\\\/pt\\\/online-payments\\\/upgrade-your-integration\\\/migrate-to-web-v6\\\/\\&quot;&gt;migration guide&lt;\\\/a&gt; to learn about the changes you may need to apply depending on what you have customized.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;If you are using the default checkout and payments logic offered with the plugin, you do not need to take any action.&lt;\\\/p&gt;\\n&lt;h2&gt;Step 4: Review breaking changes&lt;\\\/h2&gt;\\n&lt;p&gt;Version 10 of the plugin introduces breaking changes to plugin logic and functionality. If you have any customizations based on logic that was removed or added by these breaking changes, it is your responsibility to verify that your customizations are still compatible.&lt;\\\/p&gt;\\n&lt;p&gt;Review the breaking changes in our &lt;a href=\\&quot;\\\/pt\\\/plugins\\\/release-notes\\&quot;&gt;release notes&lt;\\\/a&gt; to learn if any of the changes affect your integration.&lt;\\\/p&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;migrate_to_version_10_0_1&quot;,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Migrate to version 9&quot;,&quot;content&quot;:&quot;\\n&lt;div class=\\&quot;notices yellow\\&quot;&gt;\\n&lt;p&gt;V9 introduces a new configuration page that makes it easier to configure your plugin. See the &lt;a href=\\&quot;\\\/pt\\\/plugins\\\/release-notes\\\/#releaseNote=2023-10-23-adobe-commerce-9.0.1\\&quot;&gt;release notes&lt;\\\/a&gt; for an overview of all changes.&lt;\\\/p&gt;\\n&lt;\\\/div&gt;\\n&lt;h2 id=\\&quot;upgrade-to-version-9\\&quot;&gt;Step 1: Upgrade the plugin&lt;\\\/h2&gt;\\n&lt;p&gt;Follow the &lt;a href=\\&quot;\\\/pt\\\/plugins\\\/adobe-commerce\\\/upgrade\\&quot;&gt;instructions to upgrade the plugin&lt;\\\/a&gt; to version 9.&lt;\\\/p&gt;\\n&lt;h2 id=\\&quot;upgrade-php\\&quot;&gt;Step 2: Upgrade PHP&lt;\\\/h2&gt;\\n&lt;p&gt;Adobe Commerce v2.4.4 &lt;a href=\\&quot;https:\\\/\\\/experienceleague.adobe.com\\\/docs\\\/commerce-operations\\\/installation-guide\\\/system-requirements.html\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;requires PHP 8.1 or later&lt;\\\/a&gt; to be installed on your server. Refer to the &lt;a href=\\&quot;https:\\\/\\\/www.php.net\\\/ChangeLog-8.php#8.1.23\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;PHP documentation&lt;\\\/a&gt; to see the changes for this PHP version.&lt;\\\/p&gt;\\n&lt;p&gt;If you are running a PHP version earlier than 8.1, install the required version.&lt;\\\/p&gt;\\n&lt;h2 id=\\&quot;check-dependencies-version-9\\&quot;&gt;Step 3: Check dependencies&lt;\\\/h2&gt;\\n&lt;p&gt;Version 9.0.1 of the plugin uses &lt;a href=\\&quot;\\\/pt\\\/online-payments\\\/release-notes?integration_type=api&amp;amp;version=70\\&quot;&gt;Checkout API version 70&lt;\\\/a&gt; and &lt;a href=\\&quot;\\\/pt\\\/online-payments\\\/release-notes\\\/?integration_type=web&amp;amp;version=5.51.1\\&quot;&gt;Components version 5.51.1&lt;\\\/a&gt;. If you have customized the plugin, upgrading could cause issues in the implementation of your custom code. Check if your integration is compatible with the new versions of Checkout API and Components, and apply changes if needed.&lt;\\\/p&gt;\\n&lt;p&gt;We update our plugin dependencies regularly to make new features and fixes available. If you are upgrading to a version later than v9.0.1, check our &lt;a href=\\&quot;\\\/pt\\\/plugins\\\/release-notes\\&quot;&gt;release notes&lt;\\\/a&gt; to see if the Checkout API or Web Components versions have changed.&lt;\\\/p&gt;\\n&lt;h2&gt;Step 4: Change your webhook server configuration&lt;\\\/h2&gt;\\n&lt;p&gt;If you &lt;a href=\\&quot;\\\/pt\\\/plugins\\\/adobe-commerce\\\/set-up-adyen-customer-area\\\/?tab=manual_2\\&quot;&gt;set up your integration manually&lt;\\\/a&gt;, you have to change your webhook server configuration to ensure you continue to receive webhooks from us.&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;Log in to your &lt;a href=\\&quot;https:\\\/\\\/ca-test.adyen.com\\\/\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Customer Area&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Developers&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Webhooks&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Next to the webhook you added when you &lt;a href=\\&quot;\\\/pt\\\/plugins\\\/adobe-commerce\\\/set-up-adyen-customer-area\\\/?tab=manual_2#step-3-set-up-webhooks\\&quot;&gt;set up webhooks&lt;\\\/a&gt;, select &lt;i class=\\&quot;adl-icon-options\\&quot;&gt;&lt;\\\/i&gt; &amp;gt; &lt;strong&gt;Edit webhook&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Under &lt;strong&gt;General&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Server configuration&lt;\\\/strong&gt;, select the edit icon &lt;i class=\\&quot;adl-icon-edit\\&quot;&gt;&lt;\\\/i&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Change the ending of the &lt;strong&gt;URL&lt;\\\/strong&gt; from &lt;code&gt;\\\/process\\\/json&lt;\\\/code&gt; to &lt;code&gt;\\\/webhook&lt;\\\/code&gt;. For example, from &lt;code&gt;https:\\\/\\\/THE_URL_OF_YOUR_STORE\\\/adyen\\\/process\\\/json&lt;\\\/code&gt; to &lt;code&gt;https:\\\/\\\/THE_URL_OF_YOUR_STORE\\\/adyen\\\/webhook&lt;\\\/code&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Apply&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Save changes&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;h2&gt;Step 5: Verify changes in payment methods&lt;\\\/h2&gt;\\n&lt;h3&gt;Changes to payment methods and how they are shown&lt;\\\/h3&gt;\\n&lt;ul&gt;\\n&lt;li&gt;All payment methods are now registered independently on the Adobe Commerce platform. Previously, the plugin grouped payment methods into cards and alternative payment methods. With the separation of payment methods to their own files, payment methods are sorted based on the order in your Customer Area.&lt;\\\/li&gt;\\n&lt;li&gt;You can now enable all payment methods that you have enabled in your Customer Area by selecting a single button in Adobe Commerce.\\n&lt;div class=\\&quot;notices yellow\\&quot;&gt;\\n&lt;p&gt;After upgrading your plugin, make sure that &lt;a href=\\&quot;\\\/pt\\\/plugins\\\/adobe-commerce\\\/set-up-the-payment-methods-in-adobe-commerce#enable-payment-methods-in-adobe-commerce\\&quot;&gt;you have enabled the payment methods&lt;\\\/a&gt;.&lt;\\\/p&gt;\\n&lt;\\\/div&gt;&lt;\\\/li&gt;\\n&lt;li&gt;By default, the payment methods shown to shoppers during checkout are based on their billing address country\\\/region. You can override this with the &lt;a href=\\&quot;\\\/pt\\\/plugins\\\/adobe-commerce\\\/set-up-the-payment-methods-in-adobe-commerce#alternative-payment-methods\\&quot;&gt;&lt;strong&gt;ISO Country Code&lt;\\\/strong&gt; setting&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;div class=\\&quot;accordion-shortcode adl-accordion adl-accordion--max-height-transition\\&quot; data-expand=\\&quot;true\\&quot; data-ignore=\\&quot;anchorjs-link\\&quot;&gt;\\n    \\n    &lt;div class=\\&quot;adl-accordion__item\\&quot; style=\\&quot;\\&quot;&gt;\\n        &lt;div tabindex=\\&quot;0\\&quot; role=\\&quot;item\\&quot; aria-expanded=\\&quot;false\\&quot; class=\\&quot;adl-accordion__header\\&quot;&gt;\\n            &lt;i class=\\&quot;adl-accordion__toggle adl-icon-chevron-down\\&quot;&gt;&lt;\\\/i&gt;\\n            &lt;div class=\\&quot;adl-accordion__title-wrapper\\&quot; data-accordion=\\&quot;#changes-for-customized-and-headless-integrations\\&quot;&gt;\\n                                    &lt;h3 class=\\&quot;adl-accordion__title\\&quot;&gt;Changes for customized and headless integrations&lt;\\\/h3&gt;\\n                            &lt;\\\/div&gt;\\n        &lt;\\\/div&gt;\\n        &lt;div role=\\&quot;region\\&quot; class=\\&quot;adl-accordion__content\\&quot;&gt;\\n            \\n&lt;ul&gt;\\n&lt;li&gt;If you applied customizations to the way payment methods are handled in your plugin, upgrading may cause issues in the implementation of your custom code. Check if your custom code is compatible with the new payment method set up.&lt;\\\/li&gt;\\n&lt;li&gt;For headless integrations:\\n&lt;ol&gt;\\n&lt;li&gt;You now have to send the individual payment method names in your requests &lt;a href=\\&quot;\\\/pt\\\/plugins\\\/adobe-commerce\\\/headless-integration#place-order\\&quot;&gt;when placing orders&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;You no longer need to include &lt;code&gt;shippingAddress&lt;\\\/code&gt; object in your request to the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/paymentMethods\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/paymentMethods&lt;\\\/a&gt; endpoint when &lt;a href=\\&quot;\\\/pt\\\/plugins\\\/adobe-commerce\\\/headless-integration#get-payment-methods\\&quot;&gt;getting available payment methods&lt;\\\/a&gt;.\\n\\n        &lt;\\\/div&gt;\\n    &lt;\\\/div&gt;\\n&lt;\\\/div&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;h2&gt;Step 6: Verify changes to the gift card flow&lt;\\\/h2&gt;\\n&lt;p&gt;Gift card payments have a new native flow.&lt;\\\/p&gt;\\n&lt;p&gt;Previously, shoppers were redirected to an Adyen-hosted payment page. In v9, gift card payments use the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/overview\\&quot; class=\\&quot; external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;Checkout API&lt;\\\/a&gt;  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/orders\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/orders&lt;\\\/a&gt; endpoint and shoppers can complete &lt;a href=\\&quot;\\\/pt\\\/online-payments\\\/partial-payments\\\/\\&quot;&gt;partial gift card payments&lt;\\\/a&gt; in one native flow.&lt;\\\/p&gt;\\n&lt;div class=\\&quot;notices yellow\\&quot;&gt;\\n&lt;p&gt;If you previously set up gift card payments in your integration, using the new flow requires additional configuration on our end. Contact our &lt;a href=\\&quot;https:\\\/\\\/ca-test.adyen.com\\\/ca\\\/ca\\\/contactUs\\\/support.shtml?form=other\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Support Team&lt;\\\/a&gt;.&lt;\\\/p&gt;\\n&lt;\\\/div&gt;\\n&lt;h2&gt;Step 7: Verify changes to tokenization&lt;\\\/h2&gt;\\n&lt;p&gt;The plugin uses the &lt;a href=\\&quot;https:\\\/\\\/developer.adobe.com\\\/commerce\\\/php\\\/development\\\/payments-integrations\\\/vault\\\/\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Adobe Commerce Vault&lt;\\\/a&gt; for tokenization. Previously, you could choose between storing token references in Adyen or Adobe Commerce.&lt;\\\/p&gt;\\n&lt;p&gt;If you use tokenization, you have to reconfigure the payment methods for which you want to enable tokenization, and specify a recurring processing model. Follow the instructions to &lt;a href=\\&quot;\\\/pt\\\/plugins\\\/adobe-commerce\\\/set-up-tokenization#set-up-vault\\&quot;&gt;set up the Vault in Adobe Commerce&lt;\\\/a&gt;.&lt;\\\/p&gt;\\n&lt;p&gt;If you previously used Adyen tokenization, the tokens are migrated to the Adobe Commerce Vault automatically. To verify the migration, you can manually check if your token references are stored correctly.&lt;\\\/p&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;migrate_to_version_9_1_2&quot;,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='false'>\n        <\/tabs>\n    <\/div>\n<\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/plugins\/adobe-commerce\/migrate-to-a-new-version","articleFields":{"description":"Follow these instructions to migrate your Adobe Commerce plugin to a new major version","last_edit_on":"20-08-2024 11:44","feedback_component":true,"next_steps":[{"title":"Troubleshoot","description":"Monitor your migration and follow the steps in our Troubleshooting guide if you experience any issues.","url":"\/plugins\/adobe-commerce\/troubleshooting\/","required":false}],"filters_component":false,"decision_tree":"[]","page_id":"6e775f64-164e-4183-8df5-222a52dfc4e6"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/plugins\/adobe-commerce\/migrate-to-a-new-version","title":"Migrate to a new version","content":"On this page, we describe the changes that you need to make in your existing integration when migrating to a later version of the Adobe Commerce plugin.\n\n\n    \n        \n        \n    \n\n","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Plugins","lvl2":"Adobe Commerce","lvl3":"Migrate to a new version"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/plugins","lvl2":"https:\/\/docs.adyen.com\/pt\/plugins\/adobe-commerce","lvl3":"\/pt\/plugins\/adobe-commerce\/migrate-to-a-new-version"},"levels":4,"category":"Plugins","category_color":"green","tags":["Migrate","version"]}}