Adyen User Guide

Table of Contents

Key features

• 25+ local payment methods in more than 50 countries
• Accept online payments in the WooCommerce checkout in (almost) every country worldwide.
• Adyen is used by great companies, such as: Netflix, Microsoft, Uber and many more. Therefore it is one of the most reliable payment providers.
• The country of the visitor is recognized in the checkout and only shows relevant and local payment methods for higher conversion.

Benefits

• 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 payments and subscriptions are supported in the WooCommerce checkout.
• Optionally, you can choose to make use of the Adyen Hosted Payment page.
• Configure multiple store profiles based on countries to keep a nice overview of your incoming payments.

Introduction

Adyen is a leading global payment platform used by merchants to accept online, in-store, and mobile payments. With a single integration, Adyen supports a wide range of payment methods—including credit cards, iDEAL, Bancontact, Klarna, Apple Pay, Google Pay, and many more—while providing advanced fraud protection, real-time insights, and seamless processing across all sales channels.

The Woosa Adyen for WooCommerce plugin connects your WooCommerce store directly with Adyen’s payment platform. It enables customers to pay securely within your checkout, automatically updates order statuses through Adyen’s webhooks, and offers full support for popular payment methods, refunds, captures, and localized payment options. With an easy configuration process and deep WooCommerce integration, the plugin provides a reliable and flexible payment solution for any webshop using Adyen.

1. Make Sure You Have an Adyen Account (Live or Test)

Before you install or configure the plugin, you must have access to an Adyen account. This can be either a:

• Test (Sandbox) Adyen account, or
• Live Adyen account (for real payments)

You will need this account later to retrieve your API Key, Client Key, Merchant Account, and to configure the webhook.

If you don’t have an account yet:

• Create a Test Account (recommended for setup): https://www.adyen.com/signup
• Or request a Live Account directly through Adyen.

Once you have access to the Adyen Customer Area, you can continue with the next steps.

2. Download the Plugin from Your Woosa Account

To start, we first need to download the Adyen plugin from your Woosa account.

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.

3. Upload and Install the Plugin in Your WordPress Backend

Once you've downloaded the plugin, the next step is to upload and install it in your WooCommerce store.

1. Log in to your WordPress Admin Dashboard.
2. Go to Plugins → Add New.
3. Click the Upload Plugin button at the top of the page.
4. Select the Adyen for WooCommerce ZIP file you downloaded from Woosa.
5. Click Install Now, and after installation, click Activate.

After activation, the plugin will appear as an icon on your left navigation bar at the top.

4. Authorize the Plugin with Your Adyen Account

4.1 Navigate to the Authorization Page in WooCommerce

1. Log in to your WordPress backend.
2. Go to Adyen plugin → Authorization tab

Here you will see the fields for:

• Test Mode?
• Merchant Account
• API Key
• Live URL Prefix (in Live Mode)

4.2 Get Your API Key from Adyen

You must retrieve your API key from your Adyen Customer Area.

1. Log into your Adyen Customer Area (Test or Live).
2. Go to: Developers → API credentials
3. Click on the button Create new credential
4. Choose Web service user as the Credential type (optional: fill in a description)
5. Click on the Create credential button
6. Under the Authentication header, click on Generate API Key
   1. Important:
      • Copy and securely store the API key in your system — you won't be able to see it later.
      • Please click on 'Save changes' to store and enable the newly generated API Key
7. Copy the generated API key.

Important: You can only view an API Key once. Store it safely.

4.3 Get Your Merchant Account Name

1. In the Adyen Customer Area, go to Account → Merchant accounts.
2. Copy the Merchant Account you want to use (e.g., WoosaBV12345     ).
3. Paste this into the Merchant account field in the plugin.

4.4 Get Your Live URL Prefix (Live Mode Only)

If you are configuring the plugin in Live Mode, you must enter your Live URL Prefix.

1. Log in to the Adyen Live Customer Area.
2. Go to: Developers -> API URLs
3. Locate your Live URL prefix (e.g.,1797a841fbb37ca7-AdyenDemo).
4. Copy/paste this prefix in the plugin's Authorization tab, in the field URL-prefix (LIVE).

The plugin uses this prefix to communicate with the correct live API environment.

4.5 Paste Your Credentials Into the Plugin

Fill in the fields:

• Merchant Account → paste from Adyen
• API Key → paste your API Key
• Live URL Prefix (only when in Live Mode)

Lastly, click Save changes. The plugin will automatically validate your credentials.

5. Configure the Adyen Webhooks

Webhooks are essential for updating order statuses in WooCommerce. Without a webhook, your orders will remain in Pending payment, and events like captures, refunds, and cancellations will not sync.

5.1 Standard Notification Webhook (Required)

1. Log in to your Adyen account to activate the webhooks
2. Then go to Developers -> Webhooks
3. On the Webhooks page, click (+) Create new webhook at the top right of the screen.
4. A screen will now appear, under the heading Recommended webhooks click on Standard webhook -> Add
5. Below Server configuration, enter the following information:
   • URL - https://yourdomain.nl/wp-json/woosa-adyen/payment-status          
   • Encryption protocol - TLSv12
   • Active - Checked
   • Method - HTTP POST
6. Below Authentication, enter a username and password of your choice.
7. Click on the Save Configuration button

Important: Configure the HMAC Key

It's recommended to generate an HMAC key as well, and copy/paste it in the plugin. This ensures all webhook messages are securely signed and verified, preventing tampered or fraudulent notifications.

5.2 Boleto Bancario pending

1. Log in to your Adyen account to activate the webhooks
2. Go to Developers -> Webhooks
3. On the Webhooks page, click (+) Create new webhook at the top right of the screen.
4. A screen will now appear, under the heading Recommended webhooks click on Boleto Bancario Pending -> Add
5. Below Server configuration, enter the following information:
   • URL - https://yourdomain.nl/wp-json/woosa-adyen/boleto-payment-status        
   • Encryption protocol - TLSv12
   • Active - Checked
   • Method - HTTP POST
6. Below Authentication, enter a username and password of your choice.
7. Click on the Save Configuration button

5.3 Test the Webhook

1. In Adyen, open your webhook details.
2. Click Test Configuration.
3. You should see:

200 [accepted]

If you see accepted, your webhook is active and your WooCommerce store can now receive payment status updates. If you see:

401 [unauthorized]

Then double check your credentials on both ends (username/password) and make sure they match.

6. Configure Store Profiles

What Store Profiles Do

Store profiles allow you to route online payments to different Adyen stores based on the customer’s country. This is useful when your business operates multiple regional branches or legal entities and needs transactions to flow into the correct local Adyen store.

Example:

Customers from Belgium are routed to Store One, while customers from the Netherlands are routed to Store Two.

Adyen documentation: https://docs.adyen.com/platforms/manage-stores

6.1 Create a Store in Adyen

Before you can map stores inside the Woosa Adyen plugin, you must first create them in your Adyen Customer Area.

1. Log in to your Adyen Customer Area (Test or Live).

   In the left menu, go to In-person payments → Stores.

   Click the Add stores button (top right).

   Select your Merchant account and the Country/Region for the store.

   Click Add store.

   This opens the Add store panel on the right side.

   Fill in your store details:

   • Store reference (optional)
   • Store description
   • Shopper statement
   • Address (required fields)
   • Postal code, city, phone number
2. Click Add store to save it.

Repeat these steps for every country or region where you want a dedicated store.

Your created stores will now appear in the list (e.g., Store One, Store Two, Store Three).

6.2 Configure Store Mapping in the Woosa Adyen Plugin

Once your stores exist in Adyen, you can link them to customer countries in WooCommerce.

1. Go to your WordPress backend → Adyen → Stores
2. Choose the Country source: Billing country, or Shipping country
3. Under Store configuration:
• Select an Adyen store from the dropdown
• Select the Customer country
• Click Connect
4. The mapping will appear in the list (e.g., Store One → Belgium).
5. Repeat as needed for all countries you serve.

How It Works at Checkout

When a customer checks out:

• Their billing or shipping country is detected
• The plugin selects the matching Adyen store
• The payment is routed to the correct store in your Adyen account

This ensures proper reconciliation, regional compliance, and accurate reporting in Adyen.

7. Configure payment methods

To offer payment methods in your WooCommerce checkout, you must first enable them in your Adyen Customer Area. After that, the Woosa Adyen plugin can load and display them inside WooCommerce → Settings → Payments.

7.1 Enable Payment Methods in Your Adyen Account

Step 1 Go to Payment Methods

1. Log in to your Adyen Customer Area (Test or Live).
2. Navigate to: Settings
3. Then Account management -> Payment methods

Step 2 Add Payment Methods

1. Click on the Request payment methods button.
2. Browse or search for the payment method you want to enable (e.g., iDEAL, Credit Cards, Bancontact, Klarna, PayPal via Adyen, Apple Pay, etc.).
3. Click Add or Request next to the method.

Some methods (e.g., Klarna, Apple Pay) require additional configuration or approval from Adyen before activation. Adyen docs: https://docs.adyen.com/payment-methods/add-payment-methods

Step 3 Save Changes

Once added and configured, the payment method will appear in your merchant account’s payment method list.

7.2 Refresh and Load Payment Methods in WooCommerce

The Woosa Adyen plugin automatically loads your active payment methods from Adyen — but you must refresh its cache to display newly added ones.

Step 1 Clear the Adyen Plugin Cache

1. In WordPress, go to: Adyen plugin settings → Tools
2. Click Clear cache.

This forces the plugin to fetch the latest payment methods from your Adyen account.

Step 2 Activate the Method in WooCommerce

1. Go to: WooCommerce → Settings → Payments
2. You will now see the new payment method(s) listed.
3. Enable the toggle and configure the settings (title, description, icons, etc.).

Your payment method is now active.

General settings

Dashboard

Tools