Search

Are you looking for test card numbers?

Would you like to contact support?

Plugin icon

Plugin upgrade

Learn why you need to upgrade your Adyen Magento 2 plugin, and how to do so.

Starting from version 3.0.0 of the Adyen plugin for Magento 2, Client Side Encryption (CSE) is replaced with our Custom Card Web Component. This moves the encryption of credit card data from your end towards us.

To keep your business secure and continue receiving support from Adyen, you need to upgrade your Magento 2 Adyen plugin to version 3.0.0 or later.

Not upgrading the plugin makes your business more vulnerable to security breaches where cardholder data can be stolen. This puts the security of your customers and your business at risk, and makes you potentially liable for fines, losses and costs incurred as a result of a breach.

Important changes

  • In version 3.0.0, we moved the card integration to our Custom Card Web Component. The styling for cards changed from skins to CSS.

  • In version 4.1.0, we replaced Adyen Hosted Payment Page (HPP) integration with Alternative payment methods. The styling for alternative payment methods changed from skins to CSS.
    This means that alternative payment methods such as iDEAL, Boleto, or Klarna, are now processed with our newest APIs, improving the shopper's experience by limiting the number of redirects.

  • In version 4.2.0 we added native 3D Secure 2, the latest authentication technology.

For information about other improvements to our Magento 2 plugin, refer to Release notes.

What you need to do

Upgrade your Adyen plugin:

  1. Download version 3.0.0 or higher of the Adyen plugin on Github.
  2. Move the code into your own environment, and follow the instructions below.

Generate an Adyen API key

  1. Log in to your Customer Area.
  2. Go to Account > API credentials, and select the credential for your integration, for example ws@Company.[YourCompanyAccount].
  3. Under Authentication, select Generate New API Key.
  4. Copy and securely store the API key in your system — you won't be able to restore it later.
    If your API key is lost or compromised, you need to generate a new one.
  5. Select Save at the bottom of the page.

Before going live, make sure that your API credential has the Checkout webservice role, API Clientside Encryption Payments role, and the Checkout encrypted cardholder data role. If you need to enable these roles, contact our Support Team. Without the roles you are not able to process payments through the plugin.

Set up the Adyen API key in Magento:

  1. Log in to your Magento 2 admin panel.
  2. In the main menu, go to Stores > Configuration.
  3. In the left navigation bar, go to Sales > Payment Methods.
  4. Select Adyen All-in-One Payment Solutions.
  5. In the Required Settings section, fill out the Test: Api-Key / Live: Api-Key fields.
  6. In the Live endpoint prefix field, enter the unique live url prefix: [random]-[company name].
    You can find this in your Adyen Customer Area, under Account> API URLs and Response.