Set up the plugin in Magento

Install Adyen's plugin for Magento, and configure it in your Magento admin panel.

Step 1: Install the plugin

Adyen's plugin for Magento is open-source and available on GitHub. The GitHub repository is connected to Packagist, so you can easily include it in your project through Composer.

Before you begin, make sure that you have installed Composer. In your command-line tool, go to the Magento folder and run the following commands:

Install the plugin:
```
composer require adyen/module-payment
```
Enable the plugin:
```
bin/magento module:enable Adyen_Payment
```
Execute the update scripts:
```
bin/magento setup:upgrade
```
Flush cache storage:
```
bin/magento cache:flush
```
If you are using a caching layer such as Varnish, you need to exclude the following URL pattern from being cached: /adyen/process/*.

(Optional) Use Express Checkout flows

Only possible with the Magento plugin v8.8.0 and later versions.

Express Checkout is available for Apple Pay and Google Pay. To activate the Express Checkout Module, go to the Magento folder and run the following commands in your command-line tool:

Install the plugin:

composer require adyen/adyen-magento2-expresscheckout

Enable the plugin:

bin/magento module:enable Adyen_ExpressCheckout

Execute the update scripts:
```
bin/magento setup:upgrade
```
Flush cache storage:
```
bin/magento cache:flush
```

Step 2: Run cron

To process webhook notifications, update cache, and close unfinished orders, you need to have cron running on your server. For instructions on how to set up cron in Magento, refer to Configure and run cron.

The cron job generation time interval for the adyen_payment group is set to 1 minute.

Step 3: Configure the plugin in Magento

Before you begin, make sure that you have set up your Adyen Customer Area.

Configure the Adyen plugin in your Magento admin panel:

Log in to your Magento admin panel.
In the left navigation bar, go to Stores > Configuration.
In the menu, go to Sales > Payment Methods.
Select Required Settings and fill out the following fields:

For the Magento 2 plugin v8.4.0 or later there are two ways to configure the required settings for the plugin:

Automated:
- We recommend this option if you are new to the Magento 2 plugin.
- The required settings are configured automatically for you by using your API key.
- You can also reconfigure your integration using this option, but in that case the older configuration will be lost.
Manual:
- We recommend this option if you have used the Magento 2 plugin before or if you want to re-configure your plugin.
- You manually generate credentials in your Customer Area to configure your integration.

If you are using a plugin version before v8.4.0, see the configuration options for older versions.

Field	Description
Configuration Mode	Select Automated.
Environment	Select whether you want to use test or live environment.
Test/Live API Key	The API key you generated in the Adyen test or live Customer Area.
Client key for Live/Test	Automatically fetched from your Customer Area.
Merchant Account	Name of your Adyen merchant account for which the payments will be processed.
Notification Username	Automatically generated when the webhook configuration is automatically created in the Customer Area. This is the username for basic authentication that webhook notifications from Adyen will be using.
Notification Password	Automatically generated. This is the password for basic authentication that webhook notifications from Adyen will be using.
Live prefix	Automatically fetched from your Customer Area.
Frontend resources region	Automatically set to Europe (default).
Charged currency	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. To change this setting, see Selecting charged currency.Possible values: Display currency (default) – The store view or display currency is used. Global/Website currency – The base currency is used. Depending on how Magento is configured, this will be either the Global or the Website currency.
Enable debug logging	Select Yes to enable debug logging on the Magento server.

Watch how to configure the plugin in Magento:

Step 4 (optional): Configure advanced settings

Configure the advanced settings for the plugin:

Log in to your Magento admin panel.
In the left navigation bar, go to Stores > Configuration.
In the menu, go to Sales > Payment Methods.
Select Advanced settings. Here you can find sections for configuring several advanced settings, explained below.

Magento order processing

In the Magento Order Processing section, you can configure the following fields:

Field	Description
Use manual capture for PayPal	Select Yes if you want to use manual capture for your PayPal integration.To change this setting, you first need to contact our Support Team.
Capture on shipment for open invoice methods (Klarna, Afterpay, and RatePAY)	Select Yes to automatically capture buy now, pay later (open invoice) payments such as Klarna, Afterpay, and Ratepay when a new shipment is created in Magento. You can not use this functionality if you have enabled auto-capture for buy now, pay later payment methods.

Field	Description
Use manual capture for PayPal	Select Yes if you want to use manual capture for your PayPal integration.To change this setting, you first need to contact our Support Team.
Capture on shipment for open invoice methods (Klarna, Afterpay, and RatePAY)	Select Yes to automatically capture buy now, pay later (open invoice) payments such as Klarna, Afterpay, and Ratepay when a new shipment is created in Magento. You can not use this functionality if you have enabled auto-capture for buy now, pay later payment methods.
Use auto-capture for OpenInvoice payments	Select Yes if you want to use automatic capture for your Buy Now Pay Later payment methods (Klarna, Afterpay, and Ratepay).To change this setting, you first need to contact our Support Team.
Send order confirmation email for Bank Transfer/SEPA	Select Yes to send a confirmation email to the shopper, after you received a PENDING notification from Adyen ¹ .
Sepa Payment flow	Choose the payment flow that you want to use for SEPA payments.Possible values: Sale – Use immediate automatic capture for SEPA payments. This is the default setting. Auth/Cap – Use the value that you set for Capture Delay in Adyen Customer Area.
Capture Delay	The capture delay that you set in Adyen Customer Area.Possible values: manual – Select this if you set capture delay to manual (manual capture). immediate – Select if you set capture delay to immediate.
Order status: order creation	Only applicable to payments processed with the redirect method: status given to orders before receiving an AUTHORISATION notification from Adyen.For more information, refer to Order management.
Order status: payment authorisation	Only applicable to payments with manual capture: status given to orders after receiving a successful AUTHORISATION notification from Adyen.For more information, refer to Order management.
Order status: payment confirmed	Status given to orders after the payment has been completed. When this happens depends on whether the capture is manual or automatic. Manual capture: after receiving a successful CAPTURE notification from Adyen. Automatic capture: after receiving a successful AUTHORISATION notification from Adyen. For more information, refer to Order management.
Order status: order cancellation	Status given to orders after receiving one of the following notifications from Adyen: a successful CANCEL LATION notification an OFFER_CLOSED notification a successful CANCEL_OR_REFUND notification
Order status: payment capture (virtual products)	Status given to orders of virtual products after payment is confirmed. By default, this is the same as for normal products.
Order status: pending Bank Transfer/SEPA orders	Status given to orders after receiving a PENDING notification from Adyen. By default, Adyen does not inform your Magento store about pending payments. To set them up, add BankTransfer pending and Direct-debit pending notifications when setting up webhook notifications.

Field	Description
Use manual capture for PayPal	Select Yes if you want to use manual capture for your PayPal integration.To change this setting, you first need to contact our Support Team.
Capture on shipment for open invoice methods (Klarna, Afterpay, and RatePAY)	Select Yes to automatically capture buy now, pay later (open invoice) payments such as Klarna, Afterpay, and Ratepay when a new shipment is created in Magento. You can not use this functionality if you have enabled auto-capture for buy now, pay later payment methods.
Use auto-capture for OpenInvoice payments	Select Yes if you want to use automatic capture for your Buy Now Pay Later payment methods (Klarna, Afterpay, and Ratepay).To change this setting, you first need to contact our Support Team.
Order status: payment capture (virtual products)	Status given to orders of virtual products after payment is confirmed. By default, this is the same as for normal products.
Order status: pending Bank Transfer/SEPA orders	Status given to orders after receiving a PENDING notification from Adyen ¹ .
Send order confirmation email for Bank Transfer/SEPA	Select Yes to send a confirmation email to the shopper, after you received a PENDING notification from Adyen. By default, Adyen does not inform your Magento store about pending payments. To set them up, add BankTransfer pending and Direct-debit pending notifications when setting up webhook notifications.
Sepa Payment flow	Choose the payment flow that you want to use for SEPA payments.Possible values: Sale – Use immediate automatic capture for SEPA payments. This is the default setting. Auth/Cap – Use the value that you set for Capture Delay in Adyen Customer Area.