Search

Are you looking for test card numbers?

Would you like to contact support?

Plugin icon

PrestaShop

Use Adyen's plugin for PrestaShop to accept credit card payments.

Our plugin for PrestaShop allows you to 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 stored card details, native 3D Secure 2 authentication, and is compatible with your Dynamic 3DS and AVS settings.

The plugin supports PrestaShop versions 1.6 and 1.7.

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 at https://www.adyen.com/signup.
  2. Apply for a live account with Adyen. For more information, refer to Apply for a live account. 

Step 1: Install the plugin

  1. Download the latest version of the plugin on Github.
  2. Copy the folders into the /modules/adyen folder of your main PrestaShop environment.
  3. 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.
  4. In the Payment section, find Adyen, and select:
    • Install if you are using version 1.6 of PrestaShop.
    • Enable Module if you are using version 1.7 of PrestaShop.

Step 2: Generate an API key in Adyen Customer Area

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

To generate an API Key:

  1. Log in to your Adyen Customer Area.
  2. Go to Account > Users, and click the user ws@Company.[YourCompanyAccount].

  3. Under Authentication, click Generate New API Key. 

    Don't forget to copy and securely store the API Key in your system – you will need to enter it in the PrestaShop back office in Step 3.

  4. Click Save at the bottom of the page.

Step 3: Set up notifications

Adyen uses notification webhooks to inform your PrestaShop platform of payment status changes.

To receive notifications:

  1. Log in to your Customer Area with your company-level account.
  2. Go to Account > Server Communication, and click Add next to Standard Notification.
  3. Under Transport:
    • Go to URL and enter your website URL followed by module/adyen/Notifications.
    • Select the Active check box.
    • Set Method to JSON.
  4. Under Authentication:
    • Go to the User Name and Password fields to enter a username and password for basic authentication. You also need to add these credentials in the PrestaShop back office.
  5. Expand Additional Settings:
    • Go to HMAC Key (HEX Encoded) and select Generate new HMAC key.
    • Add this HMAC Key in the PrestaShop back office.
    • Make sure to save this value explicitly.
  6. Click Save Configuration at the bottom of the page.

Step 4: 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 click 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 (Optional) Use this secure token followed by your website URL to set up your cron job processor.
API key for Test Your API key from Adyen test Customer Area.
API key for Live Your API key from Adyen live Customer Area.
Live endpoint prefix The URL prefix [random]-[company name] from your Adyen live Customer Area > Account > API URLs. For more information, refer to Checkout endpoints.

Refunds

To issue an order refund:

  1. Log into 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, click Partial Refund.
  4. Under Products, enter:
    • Quantity: The number of items refunded. Note that this must always be a whole number.
    • Amount: (Optional) The refund amount. If left empty, it is the maximum amount, including taxes, that is applicable.
  5. Additionally, you can 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. Click Partial Refund at the bottom of the page to issue the refund.

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

Test and go live

Once you have the credentials for your Adyen live account:

  1. Generate an API key in your live Adyen Customer Area.
  2. Enter the API key for live in your PrestaShop back office.

See also