PrestaShop

Our plugin for PrestaShop allows you to accept credit cards and local payment methods on your PrestaShop website, without unnecessarily redirecting to an external website. Sensitive cardholder data is collected securely using our Custom Card Component, reducing your PCI DSS compliance requirements. The plugin supports stored card details and native 3D Secure 2 authentication, and is compatible with your Dynamic 3DS and Address Verification System (AVS) settings.

The plugin supports PrestaShop versions 1.6.1 and 1.7.

You can find the Adyen Payment plugin for PrestaShop here:

• Our GitHub
• PrestaShop Marketplace

Payment methods

• Credit cards – Accept credit card payments on your website and mobile application, without redirecting to an external website. Sensitive cardholder data is collected securely using our Custom Card Component, reducing your PCI DSS-compliance requirements. The plugin supports 3D Secure payments for all countries.
• Local payment methods – Accept local payment methods including Oney.
• PayPal, Apple Pay and Google Pay - Accept global e-wallets.

Before you begin

Before you begin to integrate PrestaShop with the Adyen payments platform, make sure that you have performed the following steps:

1. Sign up for a test account with Adyen.
2. While you test your integration, you can apply for a live account with Adyen. 

Step 1: Install the plugin

You have the following options for installing the plugin:

• Download from PrestaShop Marketplace: This is the easiest option, however it's only available if you're in France or Spain.
• Download from GitHub: The easiest option if you're not in France or Spain.
• Install with Composer: An advanced option only recommended for developers.

Step 2: Generate an API key

For authenticating API requests from PrestaShop, you need to provide an API key.

To generate an API key for your test environment:

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.

To get an API key for your live environment, follow the same steps in your live Customer Area.

You will need to add the test and live API keys in the PrestaShop back office as described in Step 5.

Step 3: Generate a client key

The plugin needs the client key to show the input fields for card details.

The client key is linked to one or more allowed origins — the domains from which we expect to get your client-side requests. For example, if you're collecting shopper's payment information at: https://example.org/checkout, you would need to link the domain https://example.org as an allowed origin to your client key.

To generate a client key:

1. Log in to your Customer Area.
2. Go to Account > API credentials, and select the API credential for your integration, for example ws@Company.[YourCompanyAccount].
3. Add your domains under Allowed origins. These are the domains from which you will be sending your client-side requests.
4. Under Authentication, select Generate New Client Key.
5. Select Save.

You now have a client key for your test environment. To get a client key for your live environment, follow the same steps in your live Customer Area.

You will need to copy the test and live client keys and add them in the PrestaShop back office as described in Step 5.

Step 4: Set up notifications

Adyen uses notification webhooks to let your PrestaShop platform know whether the payment was successful, and to move the order to the next phase or cancel it. In this way, you are always informed of payment status changes, even with payment methods where the shopper completes the payment after they leave your online store.

To set up notifications in your Adyen account:

1. Log in to your Customer Area with your company-level account.
2. Go to Account > Server Communication.
3. Next to Standard Notification, select Add.
4. Under Transport:
   • At URL enter your website URL followed by module/adyenofficial/Notifications.
   • Select the Active check box.
   • Set Method to JSON.
5. Under Authentication:
   • Enter your User Name and Password for basic authentication.
   • Add these authentication credentials in your PrestaShop back office as described in Step 4.
6. Under Additional Settings:
   • Select Generate new HMAC key.
   • Securely store the HMAC key in your system.
   • Add the HMAC Key in your PrestaShop back office as described in Step 4.
7. Select Save Configuration.

Step 5: Set up the plugin in PrestaShop back office

1. In your PrestaShop back office, go to:
   • Modules and Services if you are using version 1.6 of PrestaShop.
   • Modules > Module Manager if you are using version 1.7 of PrestaShop.
2. In the Payment section, find Adyen and select Configure.

3. Fill out the following fields:

   Field	Description
   Merchant Account	Name of your Adyen merchant account for which the payments will be processed.
   Test/Production Mode	Select whether you want to use test or production (live) mode.
   Notification Username	This can be any username, as long as it matches the username for basic authentication that you entered in your Adyen Customer Area.
   Notification Password	This can be any password, as long as it matches the password for basic authentication that you entered in your Adyen Customer Area.
   HMAC key for notifications	This is the HMAC key that you generated in your Adyen Customer Area.
   Secure token for cron job	A token generated when you installed the plugin. This secures your endpoint. Underneath we show your website URL with the token attached. You need this URL plus token when you set up a cron job for processing notifications.
   API key for Test	The API key from your test Customer Area.
   API key for Live	The API key from your live Customer Area.
   Client key Test	The client key from your test Customer Area.
   Client key Live	The client key from your live Customer Area.
   Live endpoint prefix	The URL prefix [random]-[company name] from your live Customer Area > Account > API URLs. For more information, refer to Checkout endpoints.
   Apple Pay merchant name	Name of your Adyen merchant account for which the payments will be processed.
   Apple Pay merchant identifier	The Authorisation MID value in your live Customer Area > Payment methods > Apple Pay.
   Google Pay gateway merchant ID	Name of your Adyen merchant account for which the payments will be processed.
   Google Pay merchant identifier	The Authorisation MID value in your live Customer Area > Payment methods > Google Pay. When testing, you can use any value.
   Integrator Name	The name of the system integrator, in case you are using one.

Set up translations

1. In your PrestaShop back office, go to:
   • Localization > Translations if you are using version 1.6 of PrestaShop.
   • International > Translations if you are using version 1.7 of PrestaShop
2. Under Type of translation select Installed modules translations.
3. If you are using version 1.7 of PrestaShop select the Adyen module.
4. Identify the language to be modified and select Modify.
5. After modifying a translation select Save and stay or Save.

Set up open invoice payment methods

Open invoice payment methods like Klarna and Afterpay require a billing and shipping address.
To ensure your shoppers understand what data you are collecting:

1. In your PrestaShop back office, go to International > Translations.
2. Open the shop forms labels for your language and enter localized address line labels to collect the street name and the house number or name. For example, for English:
   • First address line with the ID Address: Change the label to Street.
   • Second address line with the ID Address Complement: Change the label to House number or name.
3. Select Save.
4. Repeat for all languages you are using.

Labels

With the default Prestashop configuration, to find labels:

1. Go to the International/Translations page.
2. From the Type of translation drop-down menu, select Theme Translations.
3. Look under Shop > Forms > Labels.

Set up Apple Pay

To accept Apple Pay payments:

1. Add Apple Pay in your Adyen Customer Area.
2. Contact our Support Team, and provide the domain names and shop name that you want to use.
3. In your PrestaShop back office, enter the Apple Pay merchant name and the Apple Pay merchant identifier.

Apple Pay is only available in the Safari browser.

Step 6: Set up a cron job

As described above, you need to set up webhook notifications. To process these asynchronous notifications, you need to run a cron job every minute. However, PrestaShop doesn't provide a cron service so you need to create a job outside of PrestaShop.

1. Use the cron utility on your Linux instance or an external cron job service to create a cron job that runs every minute and calls your website URL. This must be the URL with the secure token attached, as shown under the Secure token for cron job field in the admin panel (see set up the plugin in your PrestaShop back end.

2. Test whether the cron job works correctly:

   1. Enable the cron job.
   2. Place a test order with a successful payment.

   3. Verify that you have a new log file adyen_cronjob.log in your /logs/adyen folder. It can take a few minutes before the file appears.

Refund an order

To issue an order refund:

1. Log in to your PrestaShop back office.
2. In the menu, go to Orders > Orders to open the Orders overview page, and select the order you want to refund.
3. In the Orders section, select Partial Refund.
4. Under Products, enter:
   • Quantity: The number of items refunded. This must be a whole number.
   • Amount: (Optional) The refund amount. If left empty, it is the maximum applicable amount including taxes.
5. Optionally select:
   • Re-stock products: The quantity of the refunded items you specified will be added back in stock.
   • Generate a voucher: Issue a voucher instead of a refund payment. The voucher code is automatically sent to the shopper's email address.
6. Issue the refund: At the bottom of the page, select Partial Refund.

After issuing the refund, the order status changes to Refunded and a credit slip is generated.

Updating from a version earlier than 2.1.0

If you are already using an Adyen PrestaShop plugin version earlier than 2.1.0 and want to use the latest version, proceed as follows:

1. Uninstall the existing Adyen plugin.
   • In the Configure drop-down menu select Uninstall if you are using version 1.6 of PrestaShop.
   • In the Upgrade drop-down menu select Uninstall if you are using version 1.7 of PrestaShop.
2. Manually remove the /adyen folder from the /modules folder.
   This is necessary because the plugin name has changed from adyen to adyenofficial.
3. Install the latest plugin version as described in Step 1: Install the plugin.
4. Configure the latest plugin version as described in Step 4: Set up the plugin in PrestaShop back office.

Next steps