{"title":"Set up the plugin in Adobe Commerce","category":"default","creationDate":1670323860,"content":"<h2 id=\"step-1-install-the-plugin\">Step 1: Install the plugin<\/h2>\n<div class=\"additional-info-block output-inline\">\n<div class=\"additional-info-block__body\"><p><strong>Implementation examples<\/strong><br \/><img alt=\"\" src=\"\/images\/a\/1\/e\/2\/c\/a1e2c8f087730e8565e5073245582a9636238705-github-icon.png\" \/>&nbsp;&nbsp;<a href=\"https:\/\/github.com\/adyen-examples\/adyen-magento-plugin-demo\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Try it out on GitHub!<\/a><\/p><\/div><\/div>\n\n<p>Adyen's plugin for Adobe Commerce (formerly Magento 2) is open-source and available on <a href=\"https:\/\/github.com\/adyen\/adyen-magento2\/tree\/master\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">GitHub<\/a>. The GitHub repository is connected to Packagist, so you can easily include it in your project through\u00a0<a href=\"https:\/\/getcomposer.org\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Composer<\/a>.<\/p>\n<p>Before you begin, make sure that you have installed\u00a0Composer. In your command-line tool, go to the Adobe Commerce folder and run the following commands:<\/p>\n<ol>\n<li>\n<p>Install the plugin:<\/p>\n<pre><code>composer require adyen\/module-payment<\/code><\/pre>\n<\/li>\n<li>\n<p>Enable the plugin:\u00a0<\/p>\n<pre><code>bin\/magento module:enable Adyen_Payment<\/code><\/pre>\n<\/li>\n<li>\n<p>Execute the update scripts:<\/p>\n<pre><code>bin\/magento setup:upgrade<\/code><\/pre>\n<\/li>\n<li>\n<p>Flush cache storage:<\/p>\n<pre><code>bin\/magento cache:flush<\/code><\/pre>\n<div class=\"sc-notice note\"><div>\n<p>If you are using a caching layer such as Varnish, you need to exclude the following URL pattern from being cached: <code>\/adyen\/process\/*<\/code>.<\/p>\n<\/div><\/div>\n<\/li>\n<\/ol>\n<h3 id=\"use-express-checkout\">(Optional) Use Express Checkout flows<\/h3>\n<p>The Express Checkout module enables <a href=\"\/pt\/payment-methods\/express-checkout\/\">express checkout<\/a> with <a href=\"\/pt\/payment-methods\/apple-pay\">Apple Pay<\/a> and <a href=\"\/pt\/payment-methods\/google-pay\">Google Pay<\/a> and <a href=\"\/pt\/payment-methods\/paypal\">PayPal<\/a>. To use the module, you must be using:<\/p>\n<ul>\n<li>Adobe Commerce <a href=\"https:\/\/experienceleague.adobe.com\/en\/docs\/commerce-operations\/release\/notes\/adobe-commerce\/2-4-4\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">v2.4.4<\/a> or later.<\/li>\n<li>Adyen Adobe Commerce plugin <a href=\"\/pt\/plugins\/release-notes\/?title%5B0%5D=Magento%202#releaseNote=2022-10-21-magento-2-8.8.0\">v8.8.0<\/a> or later.<\/li>\n<\/ul>\n<p>To activate the Express Checkout module, go to the Adobe Commerce (formerly Magento 2) folder and run the following commands in your command-line tool:<\/p>\n<ol>\n<li>\n<p>Install the plugin:<\/p>\n<pre><code>composer require adyen\/adyen-magento2-expresscheckout<\/code><\/pre>\n<\/li>\n<li>\n<p>Enable the plugin:\u00a0<\/p>\n<pre><code>bin\/magento module:enable Adyen_ExpressCheckout<\/code><\/pre>\n<\/li>\n<li>\n<p>Execute the update scripts:<\/p>\n<pre><code>bin\/magento setup:upgrade<\/code><\/pre>\n<\/li>\n<li>\n<p>Flush cache storage:<\/p>\n<pre><code>bin\/magento cache:flush<\/code><\/pre>\n<\/li>\n<\/ol>\n<h2 id=\"step-2-run-cron\">Step 2: Run cron<\/h2>\n<p>To process webhooks, update the cache, and close unfinished orders, you need to have cron running on your server. For instructions on how to set up cron in Adobe Commerce, refer to\u00a0<a href=\"https:\/\/experienceleague.adobe.com\/docs\/commerce-operations\/configuration-guide\/cli\/configure-cron-jobs.html\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Configure and run cron<\/a>.<\/p>\n<p>The cron job\u00a0generation time interval for the <strong>adyen_payment<\/strong> group is set to one minute.\u00a0<\/p>\n<p>For webhook processing, you can also use RabbitMQ. For instructions on how to set up RabbitMQ queueing, refer to <a href=\"https:\/\/experienceleague.adobe.com\/docs\/commerce-cloud-service\/user-guide\/configure\/service\/rabbitmq.html?lang=en\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Set up RabbitMQ service<\/a>. After you have set up the queuing, you have to enable the queue in Adobe Commerce:<\/p>\n<ol>\n<li>Log in to your Adobe Commerce admin panel.\u00a0<\/li>\n<li>In the left navigation bar, go to\u00a0<strong>Stores<\/strong>\u00a0&gt;\u00a0<strong>Configuration<\/strong>.\u00a0<\/li>\n<li>In the menu, go to\u00a0<strong>Sales<\/strong>\u00a0&gt;\u00a0<strong>Payment Methods<\/strong> and select <strong>Adyen Payments<\/strong>.<\/li>\n<li>Under <strong>Testing and performance<\/strong>, set <strong>Webhook processor<\/strong> to <strong>Queue<\/strong>.<\/li>\n<\/ol>\n<h2 id=\"configure-the-plugin-in-adobe-commerce\">Step 3: Configure the plugin in Adobe Commerce<\/h2>\n<p>Before you begin, make sure that you have set up your\u00a0<a href=\"\/pt\/plugins\/adobe-commerce\/set-up-adyen-customer-area\">Adyen Customer Area<\/a>.<\/p>\n<p>There are two ways to set up the plugin:<\/p>\n<ul>\n<li>\n<p><strong>Automated<\/strong>: available for Adobe Commerce plugin version 8.4.0 or later.<\/p>\n<ul>\n<li>We recommend this option if you are new to using the Adobe Commerce plugin.<\/li>\n<li>The required settings are configured automatically for you by using your API key.<\/li>\n<li>You can also reconfigure your integration using this option, but in that case the older configuration will be lost.<\/li>\n<\/ul>\n<\/li>\n<li>\n<p><strong>Manual<\/strong>: available for all Adobe Commerce plugin versions.<\/p>\n<ul>\n<li>We recommend this option if you have used the Adobe Commerce (formerly Magento 2) plugin before.<\/li>\n<li>You manually generate credentials and configure your integration.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p>Configure the Adyen plugin in your Adobe Commerce admin panel:\u00a0<\/p>\n<ol>\n<li>\n<p>Log in to your Adobe Commerce admin panel.\u00a0<\/p>\n<\/li>\n<li>\n<p>In the left navigation bar, go to\u00a0<strong>Stores<\/strong>\u00a0&gt;\u00a0<strong>Configuration<\/strong>.\u00a0<\/p>\n<\/li>\n<li>\n<p>In the menu, go to\u00a0<strong>Sales<\/strong>\u00a0&gt;\u00a0<strong>Payment Methods<\/strong>.<\/p>\n<\/li>\n<li>\n<p>Select <strong>Configure<\/strong> next to <strong>Adyen Payments<\/strong>.<\/p>\n<\/li>\n<li>\n<p>Select\u00a0<strong>Initial setup<\/strong> and fill out the following fields:\u00a0<\/p>\n\n<div id=\"tabaJsr6\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Automated&quot;,&quot;content&quot;:&quot;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th&gt;Field&lt;\\\/th&gt;\\n&lt;th&gt;Description&lt;\\\/th&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Configuration Mode&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;Select &lt;strong&gt;Automated&lt;\\\/strong&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Environment&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;Select whether you want to use test or live environment.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Test\\\/Live API key&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The API key you &lt;a href=\\&quot;\\\/pt\\\/plugins\\\/adobe-commerce\\\/set-up-adyen-customer-area?tab=automated_1#step-1-generate-your-api-and-client-keys\\&quot;&gt;generated in the test or live Customer Area&lt;\\\/a&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Test\\\/Live Client key&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;Automatically fetched from your Customer Area.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Merchant account&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;Name of your Adyen merchant account for which the payments will be processed.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Webhook username&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;Automatically generated when the webhook configuration is automatically created in the Customer Area. This is the username for basic authentication that webhooks from Adyen will be using.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Webhook password&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;Automatically generated. This is the password for basic authentication that webhooks from Adyen will be using.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/tbody&gt;\\n&lt;\\\/table&gt;\\n&quot;,&quot;altTitle&quot;:&quot;auto-mode&quot;,&quot;oldTabId&quot;:&quot;auto-mode_1&quot;,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Manual&quot;,&quot;content&quot;:&quot;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th&gt;Field&lt;\\\/th&gt;\\n&lt;th&gt;Description&lt;\\\/th&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Configuration Mode&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;Select &lt;strong&gt;Manual&lt;\\\/strong&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Environment&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;Select whether you want to use test or live environment.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Test\\\/Live API key&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The API key you &lt;a href=\\&quot;\\\/pt\\\/plugins\\\/adobe-commerce\\\/set-up-adyen-customer-area?tab=manual_2#step-1-generate-your-api-and-client-keys-1\\&quot;&gt;generated in the test or live Customer Area&lt;\\\/a&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Test\\\/Live Client key&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The API key you &lt;a href=\\&quot;\\\/pt\\\/plugins\\\/adobe-commerce\\\/set-up-adyen-customer-area?tab=manual_2#step-1-generate-your-api-and-client-keys-1\\&quot;&gt;generated in the test or live Customer Area&lt;\\\/a&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Merchant Account&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;Name of your Adyen merchant account for which the payments will be processed.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Webhook Username&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The username for basic authentication that you &lt;a href=\\&quot;\\\/pt\\\/plugins\\\/adobe-commerce\\\/set-up-adyen-customer-area?tab=manual_2#step-3-set-up-webhooks\\&quot;&gt;configured in your Adyen Customer Area&lt;\\\/a&gt;. This is used for webhook authentication.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Webhook Password&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The username for basic authentication that you &lt;a href=\\&quot;\\\/pt\\\/plugins\\\/adobe-commerce\\\/set-up-adyen-customer-area?tab=manual_2#step-3-set-up-webhooks\\&quot;&gt;configured in your Adyen Customer Area&lt;\\\/a&gt;. This is used for webhook authentication.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;HMAC Key test\\\/live&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The HMAC key you generated when you &lt;a href=\\&quot;\\\/pt\\\/plugins\\\/adobe-commerce\\\/set-up-adyen-customer-area#step-3-set-up-webhooks\\&quot;&gt;set up webhooks&lt;\\\/a&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Front-end Resource Region&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The region from which to load your frontend resources, for example, secured field iframes. Must match the region of your live endpoint.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Charged Currency&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;Currency used for Adyen payment processing. To make sure that payments are processed in the expected currency, you can only change this setting outside of the user interface. Possible values: &lt;br\\\/&gt; - &lt;strong&gt;Display currency&lt;\\\/strong&gt; (default) \\u2013 The store view or display currency is used. &lt;br\\\/&gt; - &lt;strong&gt;Global\\\/Website currency&lt;\\\/strong&gt; \\u2013 The base currency is used. Depending on how Adobe Commerce is configured, this will be either the Global or the Website currency.&lt;\\\/li&gt;&lt;\\\/ul&gt;&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/tbody&gt;\\n&lt;\\\/table&gt;\\n&quot;,&quot;altTitle&quot;:&quot;manual-mode&quot;,&quot;oldTabId&quot;:&quot;manual-mode_2&quot;,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='true'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<\/li>\n<li>\n<p>Select <strong>Save Config<\/strong>.<\/p>\n<\/li>\n<\/ol>\n<h2 id=\"configure-order-management\">Step 4: Configure order management settings<\/h2>\n<ol>\n<li>In your Adobe Commerce admin panel, go to\u00a0<strong>Stores<\/strong>\u00a0&gt;\u00a0<strong>Configuration<\/strong>.\u00a0<\/li>\n<li>In the menu, go to\u00a0<strong>Sales<\/strong>\u00a0&gt;\u00a0<strong>Payment Methods<\/strong>.<\/li>\n<li>Select <strong>Configure<\/strong> next to <strong>Adyen Payments<\/strong>.<\/li>\n<li>Select <strong>Order management<\/strong>.<\/li>\n<\/ol>\n<h3 id=\"adobe-commerce-order-processing\">Capture settings<\/h3>\n<p>Fill out the following fields to configure capture settings:<\/p>\n<table>\n<thead>\n<tr>\n<th>Field<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><strong>Capture Delay<\/strong><\/td>\n<td>The <a href=\"\/pt\/plugins\/adobe-commerce\/set-up-adyen-customer-area\">capture delay that you set in Adyen Customer Area<\/a>. Possible values: <li> <strong>manual<\/strong>: Select this if you set capture delay to manual. <li><strong>immediate<\/strong>: Select if you set capture delay to automatic.<\/td>\n<\/tr>\n<tr>\n<td><strong>Capture for open invoice methods<\/strong><\/td>\n<td>Set a capture delay for open invoice methods. Possible values: <li> <strong>On shipment<\/strong>: Capture will automatically happen when an order is shipped to the shopper. <li> <strong>Immediate<\/strong> <li><strong>Manual<\/strong> <br\/> Contact our <a href=\"https:\/\/ca-test.adyen.com\/ca\/ca\/contactUs\/support.shtml?form=other\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Support Team<\/a> to change this setting.<\/td>\n<\/tr>\n<tr>\n<td><strong>Use manual capture for PayPal<\/strong><\/td>\n<td>Select <strong>Yes<\/strong> if you want to use <a href=\"\/pt\/online-payments\/capture#manual-capture\">manual capture<\/a> for your PayPal integration. To change this setting, you need to contact our <a href=\"https:\/\/ca-test.adyen.com\/ca\/ca\/contactUs\/support.shtml?form=other\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Support Team<\/a>.<\/td>\n<\/tr>\n<tr>\n<td><strong>SEPA payment flow<\/strong><\/td>\n<td>Choose the payment flow that you want to use for SEPA payments. Possible values: <li><strong>Sale<\/strong>: Use <a href=\"\/pt\/online-payments\/capture\">automatic capture<\/a> for SEPA payments. This is the default setting. <li> <strong>Auth\/Cap<\/strong>: Use the value that <a href=\"\/pt\/online-payments\/capture\/#delayed-automatic-capture\">you set for <strong>Capture Delay<\/strong><\/a> in the Adyen Customer Area.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3>Order status<\/h3>\n<p>You can define <a href=\"https:\/\/experienceleague.adobe.com\/docs\/commerce-admin\/stores-sales\/order-management\/orders\/order-status.html?lang=en#custom-order-status\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">custom status names<\/a> that the plugin can assign to your orders. The statuses are defined depending on the shopper actions or payment statuses.<br \/>\nFill out the following fields to define different statuses for different occasions:<\/p>\n<table>\n<thead>\n<tr>\n<th>Field<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><strong>Order creation<\/strong><\/td>\n<td>The status for new orders before payment result confirmation via server webhooks from Adyen.<\/td>\n<\/tr>\n<tr>\n<td><strong>Payment authorisation<\/strong><\/td>\n<td>The status for orders that are confirmed by an  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Webhooks\/1\/post\/AUTHORISATION\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">AUTHORISATION<\/a> webhook from Adyen.<\/td>\n<\/tr>\n<tr>\n<td><strong>Payment capture for virtual products<\/strong><\/td>\n<td>Status given to orders of virtual products after payment is confirmed. By default, this is the same as for normal products.<\/td>\n<\/tr>\n<tr>\n<td><strong>Pending bank transfer\/SEPA orders<\/strong><\/td>\n<td>By default, Adyen does not inform your Adobe Commerce store about pending payments. If you want to receive these webhooks, go to your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a> &gt; <strong>Server Communication<\/strong> and select <strong>BankTransfer Pending Webhook<\/strong> and <strong>Direct-Debit Pending Webhook<\/strong>.<\/td>\n<\/tr>\n<tr>\n<td><strong>Payment confirmed<\/strong><\/td>\n<td>The status for orders after capture result is confirmed by a  webhook: <li>  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Webhooks\/1\/post\/AUTHORISATION\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">AUTHORISATION<\/a>if capture mode is immediate <li>  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Webhooks\/1\/post\/CAPTURE\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">CAPTURE<\/a> if capture mode is manual capture.<\/td>\n<\/tr>\n<tr>\n<td><strong>Order cancellation<\/strong><\/td>\n<td>The status for orders after order cancellation is confirmed by a CANCEL_OR_REFUND webhook from Adyen. If orders are already invoiced, they will be refunded.<\/td>\n<\/tr>\n<tr>\n<td><strong>Send order confirmation email for Bank Transfer\/SEPA<\/strong><\/td>\n<td>Send a confirmation email to the shopper after you received a PENDING webhook from Adyen. If you want these webhooks to be received, go to your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a> &gt; <strong>Server Communication<\/strong> and select <strong>BankTransfer Pending Webhook<\/strong> and <strong>Direct-Debit Pending Webhook<\/strong>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>","url":"https:\/\/docs.adyen.com\/pt\/plugins\/adobe-commerce\/set-up-the-plugin-in-adobe-commerce","articleFields":{"description":"Install Adyen's plugin for Adobe Commerce, and configure it in your Adobe Commerce admin panel.\u00a0","next_steps":[{"title":"Set up the payment methods","description":"Set up the payment methods you want you offer to your shoppers.","url":"\/plugins\/adobe-commerce\/set-up-the-payment-methods-in-adobe-commerce","required":true},{"title":"Set up stored payment methods","description":"Store your shopper's payment details for later payments.","url":"\/plugins\/adobe-commerce\/set-up-tokenization","required":false},{"title":"Configure your live account","description":"Follow this checklist before you start accepting live payments.","url":"\/plugins\/adobe-commerce\/go-live-checklist","required":true}],"id":"39953650","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"27-05-2024 10:35","feedback_component":true,"filters_component":false,"search_tags":["magento","magento 2","adobe","adobe commerce"],"decision_tree":"[]","page_id":"ebc778ea-976b-442c-bf18-aea312693d40","parameters":{"logo_2":"![](\/docs\/plugins\/shopware-6\/github-icon.png?resize=25)","example_2":"[Try it out on GitHub!](https:\/\/github.com\/adyen-examples\/adyen-magento-plugin-demo)"}},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/plugins\/adobe-commerce\/set-up-the-plugin-in-adobe-commerce","title":"Set up the plugin in Adobe Commerce","content":"Step 1: Install the plugin\n\nImplementation examples&nbsp;&nbsp;Try it out on GitHub!\n\nAdyen's plugin for Adobe Commerce (formerly Magento 2) is open-source and available on GitHub. The GitHub repository is connected to Packagist, so you can easily include it in your project through\u00a0Composer.\nBefore you begin, make sure that you have installed\u00a0Composer. In your command-line tool, go to the Adobe Commerce folder and run the following commands:\n\n\nInstall the plugin:\ncomposer require adyen\/module-payment\n\n\nEnable the plugin:\u00a0\nbin\/magento module:enable Adyen_Payment\n\n\nExecute the update scripts:\nbin\/magento setup:upgrade\n\n\nFlush cache storage:\nbin\/magento cache:flush\n\nIf you are using a caching layer such as Varnish, you need to exclude the following URL pattern from being cached: \/adyen\/process\/*.\n\n\n\n(Optional) Use Express Checkout flows\nThe Express Checkout module enables express checkout with Apple Pay and Google Pay and PayPal. To use the module, you must be using:\n\nAdobe Commerce v2.4.4 or later.\nAdyen Adobe Commerce plugin v8.8.0 or later.\n\nTo activate the Express Checkout module, go to the Adobe Commerce (formerly Magento 2) folder and run the following commands in your command-line tool:\n\n\nInstall the plugin:\ncomposer require adyen\/adyen-magento2-expresscheckout\n\n\nEnable the plugin:\u00a0\nbin\/magento module:enable Adyen_ExpressCheckout\n\n\nExecute the update scripts:\nbin\/magento setup:upgrade\n\n\nFlush cache storage:\nbin\/magento cache:flush\n\n\nStep 2: Run cron\nTo process webhooks, update the cache, and close unfinished orders, you need to have cron running on your server. For instructions on how to set up cron in Adobe Commerce, refer to\u00a0Configure and run cron.\nThe cron job\u00a0generation time interval for the adyen_payment group is set to one minute.\u00a0\nFor webhook processing, you can also use RabbitMQ. For instructions on how to set up RabbitMQ queueing, refer to Set up RabbitMQ service. After you have set up the queuing, you have to enable the queue in Adobe Commerce:\n\nLog in to your Adobe Commerce admin panel.\u00a0\nIn the left navigation bar, go to\u00a0Stores\u00a0&gt;\u00a0Configuration.\u00a0\nIn the menu, go to\u00a0Sales\u00a0&gt;\u00a0Payment Methods and select Adyen Payments.\nUnder Testing and performance, set Webhook processor to Queue.\n\nStep 3: Configure the plugin in Adobe Commerce\nBefore you begin, make sure that you have set up your\u00a0Adyen Customer Area.\nThere are two ways to set up the plugin:\n\n\nAutomated: available for Adobe Commerce plugin version 8.4.0 or later.\n\nWe recommend this option if you are new to using the Adobe Commerce plugin.\nThe required settings are configured automatically for you by using your API key.\nYou can also reconfigure your integration using this option, but in that case the older configuration will be lost.\n\n\n\nManual: available for all Adobe Commerce plugin versions.\n\nWe recommend this option if you have used the Adobe Commerce (formerly Magento 2) plugin before.\nYou manually generate credentials and configure your integration.\n\n\n\nConfigure the Adyen plugin in your Adobe Commerce admin panel:\u00a0\n\n\nLog in to your Adobe Commerce admin panel.\u00a0\n\n\nIn the left navigation bar, go to\u00a0Stores\u00a0&gt;\u00a0Configuration.\u00a0\n\n\nIn the menu, go to\u00a0Sales\u00a0&gt;\u00a0Payment Methods.\n\n\nSelect Configure next to Adyen Payments.\n\n\nSelect\u00a0Initial setup and fill out the following fields:\u00a0\n\n\n    \n        \n        \n    \n\n\n\n\nSelect Save Config.\n\n\nStep 4: Configure order management settings\n\nIn your Adobe Commerce admin panel, go to\u00a0Stores\u00a0&gt;\u00a0Configuration.\u00a0\nIn the menu, go to\u00a0Sales\u00a0&gt;\u00a0Payment Methods.\nSelect Configure next to Adyen Payments.\nSelect Order management.\n\nCapture settings\nFill out the following fields to configure capture settings:\n\n\n\nField\nDescription\n\n\n\n\nCapture Delay\nThe capture delay that you set in Adyen Customer Area. Possible values:  manual: Select this if you set capture delay to manual. immediate: Select if you set capture delay to automatic.\n\n\nCapture for open invoice methods\nSet a capture delay for open invoice methods. Possible values:  On shipment: Capture will automatically happen when an order is shipped to the shopper.  Immediate Manual  Contact our Support Team to change this setting.\n\n\nUse manual capture for PayPal\nSelect Yes if you want to use manual capture for your PayPal integration. To change this setting, you need to contact our Support Team.\n\n\nSEPA payment flow\nChoose the payment flow that you want to use for SEPA payments. Possible values: Sale: Use automatic capture for SEPA payments. This is the default setting.  Auth\/Cap: Use the value that you set for Capture Delay in the Adyen Customer Area.\n\n\n\nOrder status\nYou can define custom status names that the plugin can assign to your orders. The statuses are defined depending on the shopper actions or payment statuses.\nFill out the following fields to define different statuses for different occasions:\n\n\n\nField\nDescription\n\n\n\n\nOrder creation\nThe status for new orders before payment result confirmation via server webhooks from Adyen.\n\n\nPayment authorisation\nThe status for orders that are confirmed by an  AUTHORISATION webhook from Adyen.\n\n\nPayment capture for virtual products\nStatus given to orders of virtual products after payment is confirmed. By default, this is the same as for normal products.\n\n\nPending bank transfer\/SEPA orders\nBy default, Adyen does not inform your Adobe Commerce store about pending payments. If you want to receive these webhooks, go to your Customer Area &gt; Server Communication and select BankTransfer Pending Webhook and Direct-Debit Pending Webhook.\n\n\nPayment confirmed\nThe status for orders after capture result is confirmed by a  webhook:   AUTHORISATIONif capture mode is immediate   CAPTURE if capture mode is manual capture.\n\n\nOrder cancellation\nThe status for orders after order cancellation is confirmed by a CANCEL_OR_REFUND webhook from Adyen. If orders are already invoiced, they will be refunded.\n\n\nSend order confirmation email for Bank Transfer\/SEPA\nSend a confirmation email to the shopper after you received a PENDING webhook from Adyen. If you want these webhooks to be received, go to your Customer Area &gt; Server Communication and select BankTransfer Pending Webhook and Direct-Debit Pending Webhook.\n\n\n","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Plugins","lvl2":"Adobe Commerce","lvl3":"Set up the plugin in Adobe Commerce"},"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\/set-up-the-plugin-in-adobe-commerce"},"levels":4,"category":"Plugins","category_color":"green","tags":["magento","magento 2","adobe","adobe commerce"]}}
