Adobe Commerce

Our plugin for Adobe Commerce (formerly Magento 2) gives you access to the features of the Adyen payments platform in one integration. Accept all major global and local payment methods, store your shoppers' payment details for later payments, and use our risk management system. The plugin keeps the two platforms synchronized, so you can view transaction summaries in Adobe Commerce, and switch to Adyen for more detailed reporting.

You can integrate with Adyen as your payment processor for your Adobe Commerce store with either:

• Standard plugin integration: Integrate with our plugin that gives you access to all the features and uses the Adyen Web Components to present payment options to your shoppers. For your checkout, you can use:

  • the default Adobe Commerce Checkout theme.
  • the Hyvä Checkout theme. This requires using our compatibility module for Hyvä available on versions 9.5.2 and later.

• Headless plugin integration: Build your own checkout form for an Adobe Commerce PWA storefront and process payments with a headless back end that uses the Adyen plugin.

The plugin is open source and compatible with Magento 2, Adobe Commerce, and Adobe Commerce Cloud platforms.

Features

Depending on your integration type, the following features are available for our plugin:

Feature	Standard integration	Headless integration	Standard integration with Hyvä Checkout
Credit cards
Local payment methods
Tokenization
Dynamic 3D Secure 2 authentication
Risk management
Pay by Link
Donations
Express payment methods
In-person payments
Back-end orders (MOTO)
Multiple Address Shipping

Supported versions

This documentation reflects the latest version of the plugin. You can find the latest version on GitHub.

Our plugin supports Adobe Commerce version 2.4.0 or later.

We may be unable to provide support if you are not using the default Adobe Commerce checkout. We do not recommend customizing the plugin, because this could make it harder to upgrade and maintain your integration.
If you decide to customize your integration, we recommend that you:

• Keep track of the custom code added to your integration.
• Create an issue on GitHub if you want to suggest a new feature for the plugin.
• Follow the customization best practices outlined by the Adobe Commerce DevDocs.

Support levels

We provide three levels of support for major versions of the plugin:

• Level 1: Full support.
• Level 2: High priority bug fixes and security updates.
• Level 3: Security updates only.

Major version	Release date	Level 1 support until	Level 2 support until	Level 3 support until
V7	April 2021	September 2022	March 2023	September 2023
V8	November 2021	January 2024	May 2024	January 2025
V9	October 2023	October 2024	April 2025	October 2025

How it works

When a shopper proceeds to your Adobe Commerce store's checkout page, the plugin handles the payment flow using the Adyen Checkout API. During the payment flow and after, the plugin keeps the two platforms synchronized by handling Adyen Webhooks and updating order statuses in Adobe Commerce.

You can manage orders and view transaction summaries in Adobe Commerce, while switching to Adyen for more detailed reporting and conversion analytics.

Get started

Before you begin to integrate, make sure you have followed the Get started with Adyen guide to:

• Get an overview of the steps needed to accept live payments.
• Create your test account.

While you wait for your live account credentials, you can start integrating by using your test account: 

1. Set up your Adyen test Customer Area.
2. Set up the plugin in Adobe Commerce. 
3. Set up the payment methods in Adobe Commerce.
4. Use our test card numbers to make test payments for all payment methods that you want to offer.

If you want to build a headless integration, follow our Headless integration guide.

Before going live, follow our go-live checklist to make sure you've got everything set up correctly.

See also

• Get started with Adyen
• Payment methods
• Our Adobe Commerce FAQ page