Skip to main content

Adyen Full Guide

In this article we'll explain step by step how to install and configure the Adyen plugin from start to finish.

Written by Jerry Rakels
Updated over a week ago

Key Features

  • Accept online payments in the WooCommerce checkout in (almost) every country worldwide.

  • The country of the visitor is recognized in the checkout and only shows relevant and local payment methods for higher conversion.

  • Your client can save his creditcard credentials, within his WooCommerce account for a future purchase.

  • All data is stored via tokenization, this means nothing will be actually saved or stored within the database of your webshop.

  • Payment forms are loaded within the WooCommerce checkout via an iFrame. This way, you don't have to be compliant.

  • Both single and recurring payments are supported with the WooCommerce Subscriptions plugin.

  • Payment methods are automatically populated in checkout based on selected country.

  • Including wallet payment methods like, Apple Pay, Google Pay and AliPay.

About Adyen

What is Adyen?

Adyen is a global financial technology platform that consolidates the entire payment stack—gateway, risk management, and acquiring—into a single solution. Unlike traditional setups that require multiple vendors to process a single transaction, Adyen handles the process from the moment a customer clicks "buy" until the funds hit the merchant's bank account.

Before you start: create an Adyen test account

Before connecting the Woosa plugin to your live store, you must create an Adyen Test Account (CA). This account is free and provides access to the Adyen Customer Area, where you will manage your credentials and payment settings.

How to Sign Up

  1. Fill in your business details.

    • Tip: Use a professional email address associated with your domain to speed up the automated verification.

  2. Select your primary country and industry.

  3. Once you submit, Adyen will send a confirmation email. Click the link to activate your account and set your password.

What’s inside the Test Account?

Once logged in, you will be in the Test Customer Area. Here is what you’ll need for the plugin configuration later:

  • Merchant Account Name: The unique identifier for your store.

  • API Credentials: The "key" that allows WooCommerce to talk to Adyen.

  • Webhooks: The system that tells your site "the payment was successful."

Download, install & activate the plugin

Get a subscription

Before you can begin working with the plugin, you need a subscription. You can purchase one at woosa.com.

Download the plugin

After the subscription is purchased, you can now download the plugin. Please follow these steps:

  1. Log in to your Woosa account via app.woosa.com.

  2. Navigate to the Licenses tab in your dashboard.

  3. Locate Adyen for WooCommerce in your list of active products.

  4. Copy your license key (you will need this later to activate updates).

  5. Click Download to save the latest plugin ZIP file to your computer.

You do not need to extract the ZIP file.

Install & activate the plugin

Now that the plugin is downloaded, we can upload and install it on WordPress. Please follow these steps:

  1. Log in to your WordPress backend

  2. Go to the Plugins page

  3. On top of the page, click on Add new plugin

  4. Then click on Upload plugin

  5. Click on Choose file

  6. Locate the plugin in your files and click on Open

  7. Then, click on Install now

  8. Lastly, click on Activate plugin

Activate the plugin with your Woosa license key

Get your license key

After plugin installation, we must activate it with your Woosa license key, or else it won't work. Please follow these steps:

  1. Log in to your app.woosa.com account

  2. Go to the Licenses tab

  3. Look for the Adyen plugin, and copy the license key

Activate the plugin with your license key

Now that you have copied your license key, we can activate the plugin in your WordPress backend. Please follow these steps:

  1. Log in to your WordPress backend

  2. Click on Adyen on your left navigation bar

  3. On that page, paste the license key in the license field

  4. Lastly, click on Activate

Authorize your Adyen test account

To authorize your Adyen test account, you'll first need to login here. Then follow these steps:

  1. Once logged in your Adyen account, click on the top left corner on your Merchant account to select the correct account to authorize

  2. Go to Developers -> API credentials

  3. On the top right corner, click on Create new credential

  4. A pop-up will show Create API credential, choose for Web service user

  5. The username is automatically generated, you can fill in any Description of your choosing (for example: Woosa Adyen) to make it easier to identify

  6. Click on Create credential

  7. Under Server settings > API key there's already an API key generated for you automatically. Please copy and paste this key in a document on your computer or cloud, because once this API key is created, most of it will be blurred out afterwards

  8. Below click on Save changes

Authorize the Adyen plugin in your WordPress backend

Using the API credentials created above, we will now use these credentials to authorize the Adyen plugin in your WordPress backend. Follow these steps:

  1. Once logged in your WordPress backend, go to WooCommerce -> Settings

  2. Then Adyen -> Authorization

  3. After that fill in the following:

    1. Test mode = Yes

    2. Merchant Account (TEST)

    3. API key (TEST) (You saved this API key in a document on your computer or cloud, in the previous steps)

  4. Finally click on Click to authorize

Authorize your Adyen live account

To authorize the live account it's prettty much the same as your test account. Repeat the steps from Authorize your Adyen test account, but this time login to your Adyen live account here.

The only difference with the live account is that now you also need your URL-prefix (LIVE). Please read this article to find out how to create this.

Configuring the webhooks

Activating Adyen webhooks is necessary to receive current payment statuses. We are happy to explain how to activate the webhooks.

  1. Log in to your Adyen account to activate the webhooks

  2. Then go to Developers -> Webhooks

  3. On the Webhooks page, click (+) Webhook at the top right of the screen.

  4. A screen will now appear, under the heading Recommended webhooks click on Standard notification -> Add

  5. Below Server configuration, enter the following information:

  6. Below Authentication, enter a username and password of your choice.

  7. Click on the Save Configuration button

Are you ready in your Adyen account? Then you need to fill in the created username and password in step 6, in WooCommerce. To do this, go to Adyen -> Webhooks and fill in the details. Don’t forget to click on Save Changes.

Are you using the Boleto payment method?

Then repeat the steps above for the Boleto Bancario Pending Notification. Use the exact same username and password when doing so.

Configure the Adyen payment methods

After you have configured the settings of the Adyen plugin, you can configure the payment methods. The Adyen WooCommerce plugin currently supports the following payment methods:

Method of payment

  • Alipay (CN)

  • Bancontact (BE)

  • Credit Card

  • Blik (PL)

  • Boleto (BR)

  • Dotpay (PL)

  • Giropay (DE)

  • iDeal (NL)

  • Klarna (Pay Later, Pay Over Time, Pay Now)

  • PayPal

  • Sofort

  • Wechat Pay (CN)

  • GrabPay

  • MobilePay (DK, FI)

  • Vipps (NO)

  • Swish (SE)

Activate payment methods in Adyen

  1. Log in to your Adyen account here

  2. Go to Settings -> Payment methods

  3. If the status is on Active then the payment methods could also be activated in WooCommerce

  4. Is your desired payment method not in the list? Click on top right corner on Request payment methods

  5. In the Search bar, type in your desired payment method(s)

  6. Finally click on Submit

Activate payment methods in WooCommerce

  1. Go to WooCommerce > Settings > Payments

  2. Click on one of the payment methods to activate it and adjust the description in the checkout process

  3. Lastly, click on Save Changes

Are the payment methods not showing in the checkout?

Sometimes it happens that the payment methods are not showing in the checkout of your WooCommerce webshop. You can solve this easily yourself by following the rules below:

  1. Go to WooCommerce -> Settings -> Adyen -> Tools

  2. Click next to Clear cache on the button Click to run

  3. All set, when you refresh the WooCommerce checkout you should see the payment methods

Or the desired payment method isn't available for your shop's currency or country. At the top of this article, you can refer to the payment method and see which country is supported in checkout.

Are you getting an error message when activating payments in WooCommerce? Make sure they are activated in your Adyen account.

Create and connect a store in the Adyen plugin

Create stores in your Adyen account

First, we begin by creating the stores in your Adyen account, before we can connect them to the plugin in WooCommerce. Please follow these steps:

  1. Log in to your Adyen account

  2. In your dashboard left side nav menu, navigate to In-person payments -> Stores

  3. In the upper-right corner, click on Add stores

  4. From there, configure the following options:

    1. Merchant account

    2. Country/Region

    3. Payment methods

  5. In the last step, click on Add store again. There you fill out more information, such as Store information (Country and address)

  6. Click on Update store

  7. Finally, for the last step, click on Submit request

Connect store in the Adyen plugin

Now that we have created the store in Adyen, we can connect it with the Adyen plugin in WooCommerce. To do so, please follow these steps:

  1. Log in to your WordPress backend

  2. Go to the Adyen plugin settings

  3. Click on the Stores tab

  4. From there, you need to configure the following options:

    1. Country Source (Define either the billing or shipping customer country to be used for identifying the corresponding store.)

      1. Billing country or,

      2. Shipping country

    2. Adyen store

    3. Customer Country


Can’t figure it out? You can always send a message to the support team via the chat bubble at the bottom right 🎈 Support to the rescue 👨‍💻 👩‍💻

Did this answer your question?