Must read

A letter to the WooCommerce community

adyen hosted checkout woocommerce

Adyen

Developed by Woosa
Accept 30+ local payment methods. Integrate with the WooCommerce checkout seamlessly.

€99

monthly

Last updated

January 29, 2026

Version

1.18.3

The number #1 Adyen WooCommerce plugin

Start accepting payments in the WooCommerce checkout through Adyen. Used by great companies, such as: Netflix, Microsoft, Uber and many more.

A payment process seamlessly integrated with WooCommerce

  • Single and recurring payments supported with local payment methods.
  • Embedded checkout fields for compliance and a seamless checkout experience.
  • Customers can save credit card credentials to speed up future purchases and increase conversion on repeat orders.
  • Recognize countries and payment methods in the WooCommerce checkout.

Configure your payment methods to your needs

  • Change the payment method title and image in checkout.
  • Apply a surcharge for using a certain payment method.
  • Apple Pay and Google Pay are supported with a single click.
  • Connect different Adyen stores to a specific country for multilingual websites.
  • Gift cards are supported and can be enabled in the WooCommerce checkout.

Requires some technical set-up

To start accepting payments with the Adyen WooCommerce plugin, you will need to configure the following elements:

  • Retrieve your Merchant Account Name and API key to connect your Adyen account.
  • Create a webhook in the Adyen Customer Portal and enable in the plugin settings.
  • Both test and production environments of Adyen are supported.

What do you need?

  • Get in touch with Adyen and create a test account.
  • Download our Adyen WooCommerce plugin for free.

Additional recommendations

Our plugin requires serious resources. The Adyen WooCommerce plugin will not only process payments, but will also update payment statuses or trigger recurring payments. A cheap shared hosting plan, will not do the trick. This will cause the update task to pile up, meaning payment statuses will be updated with a big delay or even get stuck.

If you’re not sure, you can consider moving your hosting to Woosa. Explore our WooCommerce hosting plans here.

Minimum requirements

  • PHP version: 8.3.x
  • WordPress version: 6.4.x
  • WooCommerce version: 5.0.x
  • MySQL version: 8.0.x or MariaDB version: 10.6.x
  • HTTPS-support

Server recommendations

  • Nginx, Apache of LiteSpeed server
  • WordPress Memory Limit 1024 MB or higher (maximum 2048 MB)
  • Post size maximum 512 MB
  • PHP time limit 300
    PHP max vars 10000

Automatic installation

How do I install the Woosa plugin on my site, using the WordPress dashboard.

  1. Login to your WordPress dashboard and go to the menu Plugins
  2. Click the button -> left above -> Add new
  3. Click the button -> left above -> Upload plugin
  4. Click the button Choose file and select zip file you have just downloaded and click Open
  5. Click the button Install now
  6. The installation can take a couple of seconds. When the installation is completed, you can click the button Activate plugin.

Manual installation

How do I install the Woosa plugin on my site, using FTP.

  1. First, you will need to unpack the zip file downloaded in the previous step.
  2. Access your WordPress site through FTP and navigate to the /wp-content/plugins/ directory.
  3. Inside there, upload the entire ‘integration-adyen-woocommerce’ folder that you have obtained as result of unzipping the zip file.
  4. Once the plugin is fully uploaded to your FTP, go to your WordPress dashboard and navigate to the menu Plugins
  5. Find the plugin you have just installed and click the link Activate

Automatic updates

Automatic updates will be pushed to your WordPress backend. From there you can update the plugin with a simple click. Always backup your store, before running any updates is recommended.

1.20.1 – 2026-06-18

Fixed
  • The order status goes to failed when the payment refund fails
  • Fatal error while displaying payment methods on order pay page
  • MySQL deadlocks caused by concurrent requests all attempting to refresh the payment methods cache simultaneously
  • On multi-server setups a skipped/locked API response is being cached as a false negative
  • Customers being redirected to the Adyen domain after completing external payments when a URL-relativization plugin is active

1.20.0 – 2026-05-21

Changed
  • The Gift Card payment method has been redesigned as a dedicated section on the checkout page, which can be enabled or disabled directly from the plugin settings

1.19.0 – 2026-04-09

Added
  • New payment methods: ZIP and Afterpay
Fixed
  • Blik payment method fails on classic checkout page
  • Outdated documentation links

1.18.4 – 2026-02-19

Changed
  • Replaced support chat back to Intercom

1.18.3 – 2026-01-29

Fixed
  • In some cases the order is marked as failed due to multiple requests in the same time
  • Error Not allowed to change the shopperInteraction
  • NL country was missing for Klarna - Pay over time
  • Uncaught Error: The name property for the payment method must be a string
  • A security vulnerability in logs handling

1.18.2 – 2025-12-04

Fixed
  • Card form icons are not displayed properly

1.18.1 – 2025-10-30

Changed
  • Updated the settings page with a new logo and refreshed color scheme
  • Switched support chat provider from Intercom to Help Scout
Fixed
  • Improved compatibility with multi-currency plugins to prevent payment failures during recurring, refund, and capture transactions
  • Recurring payment refusal details are not correctly stored

1.18.0 – 2025-10-16

Added
  • New setting option to define a surcharge for each payment method
  • New setting option to enable L2/L3 enhanced scheme data for Card payment method
  • New setting option to select the proxy server region
  • The order number (or ID) is now attached to the transaction as metadata with the key shop_order_number
  • Recurring payment refusal details are now stored in order meta:
    • _adn_payment_refusalReason – the reason for the refusal.
    • _adn_payment_refusalReasonCode – the refusal code.
Fxied
  • When a saved card is removed from a recurring transaction it won’t be saved again when customer pays manually
  • Gift Card amount is not calculated properly leading to not closing the Adyen order
  • Shopper interaction is not correctly set for Card payment method
  • Sometimes the order status is set to on-hold due to late processing of the payment details

1.17.1 – 2025-07-31

Fixed
  • Changing shipping method does not update totals for Apple pay or Google pay
  • The Gift card payment method gets refunds due to Adyen order is not closed properly
  • Critical errors thrown by payment method SEPA Direct Debit

1.17.0 – 2025-07-03

Changed
  • The SEPA Direct Debit can be now enabled as a normal payment method in shop checkout page
Fixed
  • The “Capture Payment” button is not displayed properly on orders edit page when the setting option “Capture Mode” is set to “Delay” or “Manual”.
  • In some cases the manual transaction review in Adyen is not taken into account by the plugin

1.16.0 – 2025-06-05

Added
  • New payment method called ACH Direct Debit
  • New setting option to decide whether or not to add store ID to the merchant reference
  • The payment method Klarna Over Time is now supported in Canada as well
Changed
  • The plugin is no longer listen for Adyen webhook event CANCEL_OR_REFUND
  • General improvements to the payments logic dedicated for checkout blocks page
Fixed
  • An expired offer can overwrite a successful payment
  • The error Uncaught TypeError: response.setOption(...) is not defined

1.15.0 – 2025-04-17

Added
  • A toggle menu has been added to the plugin settings for mobile device views
Changed
  • The gift card payment method has been updated to support up to 5 cards. However, these changes currently prevent the payment method from being supported in WooCommerce checkout blocks
Fixed
  • Error Incorrect locale information provided
  • Missing PSP-reference when payment is reviewed

1.14.1 – 2025-03-27

Fixed
  • The Bancontact payment method failed to collect card details
  • Expanded the list of failure statuses that trigger proxy disabling

1.14.0 – 2025-03-20

Changed
  • The iDeal payment method has been upgraded to version 2.0 according to Adyen requirements
Fixed
  • No payment methods available when renew a failed order
  • Incorrect order status when transaction is under review

1.13.0 – 2025-02-13

Added
  • New payment method Twint
  • Support for recurring payments for PayPal
  • New hook adn\logger\get_file_dir for the path where logs are saved
Fixed
  • The error CRITICAL Uncaught DivisionByZeroError: Division by zero in [..] when PHP max_execution_time is 0

1.12.3 – 2024-12-19

Changed
  • Added hashes to log file names to enhance security

1.12.2 – 2024-12-16

Fixed
  • Using a later hook in the core logic causes the filtering of the existing payment methods to fail

1.12.1 – 2024-12-12

Fixed
  • Security issue regarding to log files
  • The premature triggering of the translation warning
  • Excessive log files are being generated during attempts to retrieve Adyen payment methods

1.12.0 – 2024-12-05

Added
  • New payment method named Gift Card
Changed
  • The payment method Credit Card has been renamed to Card
Removed
  • The following payment methods are no longer available: Giropay, Sofort

1.11.3 – 2024-11-07

Changed
  • Add suffix for composer autoloader class
Fixed
  • The URL for downloading Apple Pay certificate is broken

1.11.2 – 2024-10-10

Fixed
  • Clicking on the Credit Card field Name makes the menu dissappears
  • Some documentation links are outdated
  • In PHP 8.2 there are some warnings about dynamic properties

1.11.1 – 2024-09-12

Changed
  • A second parameter has been added fo the hook \rest_api\payload_data
Fixed
  • Recurring payment is not working properly

1.11.0 – 2024-07-18

Added
  • Support for the new WooCommerce Checkout Blocks
Fixed
  • Credit card translation is reseting to EN when the zipcode is filled in
  • The error message The Payment was not successful is displayed way before the payment actually fails

1.10.1 – 2024-06-20

Fixed
  • The Adyen store identification is failing for some shops
  • The translation of payment methods is not working properly

1.10.0 – 2024-05-23

Added
  • A new settings section called Stores allows you to define which Adyen stores to use based on the customer’s country
Fixed
  • Refund amount greater then 1000 is not displayed correctly in the order note
  • Google pay icon is displayed only with white color

1.9.1 – 2024-03-21

Fixed
  • The plugin zip file has been compiled with errors

1.9.0 – 2024-xx-yy

Added
  • New design for the settings page
  • New hook added: \service_util\manual_payment_methods\list
Changed
  • No longer offer the plugin for free on wordpress.org
Fixed
  • Validation of HMAC is working properly
  • The option to enable/disable installments is not working

1.8.0 – 2024-01-23

Added
  • New payment method Trustly (only one-time payments)
  • New hooks have been added: adn\core_hook_assets\public_assets, adn\validate_fields\require_cardholder_name , adn\validate_fields\require_cardholder_name, adn\validate_fields\require_cvc, adn\rest_api_hook\unexpected_event, adn\rest_api\is_authenticated\force_full_authentication, adn\rest_api\is_authenticated\log_unauthenticated_attempt
Changed
  • Return specific response for unauthenticated Adyen webhooks
  • For recurring payments the request property paymentMethod/recurringDetailReference has been replaced with paymentMethod/storedPaymentMethodId
Fixed
  • Don’t hide the processing message when performing a redirecting payment
  • Too small 3DS authentication pop-up window

1.7.0 – 2023-09-28

Added
  • Added support for HPOS (High-Performance Order Storage)
  • The following hooks have been added: adn\order\payment_result, adn\process_refund\allow_sepa_direct_debit_refunds_after_capture, adn\rest_api\payload_data, adn\rest_api_hook\authorisation\manual_immediate_capture, adn\rest_api_hook\authorisation\payment_completed, adn\rest_api_hook\authorisation\payment_failed, adn\rest_api_hook\cancellation\success, adn\rest_api_hook\cancellation\failure, adn\rest_api_hook\capture\payment_completed. adn\rest_api_hook\capture\payment_failed, adn\rest_api_hook\capture_failed, adn\rest_api_hook\refund\sucess, adn\rest_api_hook\refund\failure, adn\rest_api_hook\refund_failed, adn\rest_api_hook\cancel_or_refund\success, \rest_api_hook\cancel_or_refund\failure, adn\rest_api_hook\recurring_contract
Changed
  • In case the proxy is not available then use fallback API endpoints

1.6.1 – 2023-07-20

Fixed
  • Some payment methods are not properly displayed on the checkout page due to a JS error
  • The test mode is not correctly set for Google Pay

1.6.0 – 2023-07-13

Added
  • Added the payment method Online banking Poland which replaces the old one DotPay
Changed
  • The JS library of Adyen Web Component has been upgraded from v4.8.0 to 5.33.0
  • The Adyen API versions have been ugraded as follow: Checkout from v67 to v68 and Recurring from v49 to v68
  • The error message “Notifications could not be authenticated..” has been improved to show more details for a better troubleshooting
Removed
  • The payment method DotPay has been removed since is replaced by Online banking Poland

1.5.3 – 2023-06-07

Fixed
  • Fixed the error PHP Warning: Undefined array key "path"...

1.5.2 – 2023-05-09

Fixed
  • The credit card form slides up and down when the user is typing in the address fields
  • For some shops the Adyen webhooks fail due to an internal error

1.5.1 – 2023-03-23

Fixed
  • Google pay cannot be enabled due to a change in the method name generated by Adyen
  • Correct the typo in the plugin installation steps
  • The authorization of webhooks fails if the password has special characters
  • The UI of Authorization page is broken
Changed
  • The support chat is now available in the plugin settings

1.5.0 – 2023-01-17

Added
  • Added new payment method Swish
  • Added new payment method Bancontact mobile
  • Added new payment method Vipps
  • Added new payment method MobilePay
  • Added new payment method MolPay
  • Added new payment method GrabPay
  • Added support for using HMAC signature for Webhooks
Changed
  • In case an order payment fails the error reason is saved now as note on the order
  • The credit card form is expanding now automatiacally if there are not saved cards
Fixed
  • Format the shop languages which contain suffixes like _formal or _informal to avoid errors in the request to Adyen

1.4.2 – 2022-12-22

  • [FIX] – The tax calculation does not take into account correctly the WooCommerce tax settings

1.4.1 – 2022-11-29

  • [FIX] – The Apple Pay token is not generated
  • [FIX] – The tax is not taken into account in checkout, this leads to error Apple Pay token amount-mismatch
  • [FIX] – Cancelled payments doesn’t correctly redirect

1.4.0 – 2022-06-15

  • [FIX] – Allow special characters for cardholder name
  • [FIX] – Fix the warning Warning: Invalid argument supplied for foreach() in /home/users/ivn-dev/public_html/content/plugins/integration-adyen-woocommerce/includes/service/class-service-checkout.php on line 163
  • [FIX] – For products with price 0 the tax is calculated wrongly
  • [FIX] – Let WooCommerce to mark the order status as Completed for virtual & downloadable products
  • [TWEAK] – Stop sending remote requests if the last response is 401 unauthorized
  • [TWEAK] – Upgrade Adyen Web component from v4.4.0 to v4.8.0
  • [FEATURE] – New setting option for each payment method to define a custom icon

1.3.2 – 2022-04-12

  • [FIX] – Authorization of the plugin gets failed in some scenarios
  • [CHANGE] – Replace Adyen’s PHP library with our custom logic
  • [TWEAK] – Added step-by-step guide how to configure Apple pay payment method

1.3.1 – 2022-03-15

  • [FIX] – The price tax is not calculated correctly for line items

1.3.0 – 2022-02-09

  • [FEATURE] – Added new payment method Dotpay
  • [FEATURE] – Added new payment method BLIK
  • [FEATURE] – Added new payment method Apple Pay
  • [IMPROVEMENT] – Make more logic consistency between all payment methods
  • [TWEAK] – The “Notification” settings section has been renamed to “Webhooks” to be consistent with Adyen
  • [TWEAK] – The recurring reference is now used from the shop subscription instead to be retrieved from Adyen over and over again
  • [TWEAK] – When a customer removes its personal data a note will be created on the order

1.2.1 – 2022-01-11

  • [FIX] – Credit card form error in Javascript which affected the holder name field
  • [FIX] – Use the first payment reference from the parent order instead of the subscription
  • [FIX] – Add extra checks for Bancontact to make sure it gets the correct recurring reference

1.2.0 – 2021-08-05

  • [FIX] – Wrong config for Google Pay
  • [FIX] – Failed/canceled payments redirect to thank you page instead of the pay order page
  • [FIX] – Installments are not displayed for credit card
  • [FIX] – Wrong supported countries for Klarna
  • [FEATURE] – Added recurring payments support for Klarna payment method

1.1.4 – 2021-05-27

  • [FIX] – Fix Javascript conflict on License section

1.1.3 – 2021-05-13

  • [FIX] – Sending payment details fails in some cases due to cookie
  • [FIX] – Undefined function in Paypal method
  • [FIX] – Change Google pay icon
  • [IMPROVEMENT] – Upgrade Adyen PHP client library from v5.0.0 to v10.1.0
  • [IMPROVEMENT] – Upgrade Adyen JS component from v3.12.1 to v4.4.0
  • [TWEAK] – Small changes to Tools section

1.1.2 – 2021-04-12

  • [IMPROVEMENT] – Rebuilt license management and the logic of receving updates

1.1.1 – 2020-10.03

  • [FIX] – Fixed missing icon on “Use new card” button in checkout page
  • [FIX] – Stored cards are not removed properly from the general cache and this gives conflicts for guest users
  • [FIX] – Fixed wrong variable name “$s_address”
  • [FIX] – Integration of Giropay payment method is changed to “API-only” mode because it does not work properly via JS component
  • [FIX] – Mount the JS component of credit card form only once to avoid multiple unnecessary calls
  • [FIX] – Inform the admin by a warning message when the domain key must be manually re-generated

1.1.0 – 2020-09.09

  • [FIX] – Added a new setting option to define a “Reference Prefix” to avoid conflicts in processing orders on multisite installation
  • [FEATURE] – Added PayPal payment method (no recurring payments supported yet)
  • [FEATURE] – Added Klarna payment method (no recurring payments supported yet)
  • [FEATURE] – Added a new option to allow customers to remove their payment personal data according to GDPR
  • [FEATURE] – Added recurring payments support for Google Pay payment method
  • [TWEAK] – Added more data in the API requests to avoid fraud detection
  • [TWEAK] – Display supported countries and currencies on each payment method
  • [TWEAK] – Added a new settings section called “Tools”

1.0.10 – 2020-08.13

  • [FIX] – Added support for Bancontact payment method to be used with subscrptions as well
  • [FIX] – Exclude stored credit cards from the general cache
  • [FIX] – Fixed broken design of credit cards form in the checkout page
  • [FIX] – Fixed JS scripts issue in WordPress 5.5

1.0.9 – 2020-07.23

  • [FIX] – Added support for variable subscription products to avoid the “pending payment” order status
  • [FIX] – Made house number optional when paying with credit card
  • [FIX] – Fixed the empty user reference when paying with a saved credit card
  • [FIX] – Encapsulated the entire code to avoid conflicts with other plugins which use the same dependency libraries

1.0.8 – 2020-06-29

  • [FIX] – The origin key was not regenerated on saving settings action

1.0.7 – 2020-06-25

  • [FIX] – Fixed wrong reference for recurring orders
  • [FIX] – Cache the available payment methods to increase the speed time
  • [FIX] – Fixed conflicts for generating the origin keys
  • [TWEAK] – Rearranged the settings page and made it accessible even if the license is inactive

1.0.6 – 2020-05-01

  • [FIX] – Fixed the problem of removing stored cards from “My account” page
  • [FIX] – Fixed wrong payment url for subscription products
  • [FIX] – Fixed credit cards conflict for guest users
  • [TWEAK] – Do not regenerate the credit card form when the checkout contents reload
  • [TWEAK] – Add extra info (billing address) in the payment request

1.0.5 – 2020-02-19

  • [FIX] – Credit card form is not loading due to origin keys is not generated
  • [FIX] – Credit card form multiple click events conflict
  • [FEATURE] – New option to set whether or not to remove plugin data on uninstall
  • [TWEAK] – Rearrange settings sub-tabs
  • [TWEAK] – Add falback for JS file dependencies

1.0.4 – 2020-01-09

  • [FEATURE] – Added Google Pay payment method
  • [FEATURE] – Added Wechat Pay payment method
  • [TWEAK] – Show authentication status
  • [TWEAK] – Add caching for some API requests and a button to clear this cache

1.0.3 – 2019-11-26

  • [FEATURE] – Boleto payment method added
  • [FEATURE] – Alipay payment method added
  • [FEATURE] – Card installments support added
  • [FEATURE] – New option to capture payments manually
  • [FEATURE] – New option to save credit cards for future payments
  • [FEATURE] – New section in My Account page to display the saved credit cards

1.0.2 – 2019-09-25

  • [FIX] – Fixed missing function for getting subscriptions

1.0.1 – 2019-09-20

  • [FIX] – Fixed activation plugin issue

1.0.0 – 2019-09-05

  • This is the first release, yeey!

Do I need an Adyen account to use this plugin?

Yes, you’ll need to contact Adyen to set up an account (you can start with a test account). Once you have your Merchant Account Name and API key, you connect it to the plugin.

Is the plugin free?

No, this is a premium plugin at €99/month, which includes unlimited site licenses, unlimited plugin updates and premium plus community support.

Which payment methods are supported?

30+ local and global methods, including Card, iDEAL, Klarna, Apple Pay, Google Pay, PayPal, SEPA Direct Debit, ACH Direct Debit, Bancontact, Blik, Trustly, Swish, Twint, Vipps, MobilePay, Gift Cards, ZIP, Afterpay, and more. Availability depends on the customer’s country and currency.

Does it support recurring/subscription payments?

Yes, the plugin supports both single and recurring payments, integrating with WooCommerce Subscriptions. Recurring is supported on credit card, PayPal, Klarna, Google Pay, and other methods.

Can customers save their cards?

Yes, customers can securely store card credentials for faster future checkouts, which helps boost conversion on repeat orders. They can also remove their stored data in line with GDPR.

What technical setup is required?

You need to retrieve your Adyen Merchant Account Name and API key, create a webhook in the Adyen Customer Portal and enable it in the plugin settings. Both Adyen test and production environments are supported.

Does it work with WooCommerce Checkout Blocks?

Yes, the plugin supports both the classic checkout and the newer WooCommerce Checkout Blocks, as well as HPOS (High-Performance Order Storage).

Can I add a surcharge or change how a method appears?

Yes, you can apply a surcharge per payment method, change each method’s title and icon in checkout, and enable Apple Pay and Google Pay with a single click.

Can I run multiple Adyen stores for different countries?

Yes, the Stores settings section lets you connect different Adyen stores to specific countries, which is useful for multilingual or multi-region sites.

€99

monthly

Last updated

January 29, 2026

Version

1.18.3

Active installations

150+

Free Discord community

Get in touch with other like-minded entrepreneurs, working with WooCommerce and Woosa and experts.

All our premium plugins include advanced features and services

Free heartbeat feature

We have configured our own server and heartbeat, to bypass the default WooCommerce Scheduled Actions and wp_cron. You can enable this with one click in each of our plugins.

List of queued tasks

Our plugin provides a list of queued tasks and progress. If in any case the queue gets stuck, you can easily discover the bottleneck and debug.

Advanced (dev) tools

You can increase the resource usage, allow long-running requests or clear the plugin cache from the tools section in each of our plugins. In that way, many issues get solved with one click.

Free plugins

Make your WooCommerce store and workflow complete with premium plugins.

×