Choosing the right payment partner can make or break your online business. Adyen offers a single, global platform for processing everything from credit cards and digital wallets to local payment methods and multi-vendor marketplace payouts. In this guide, we’ll take store owners, developers, and agencies through integrating Adyen into a Shopware 6 store, covering both straightforward B2C scenarios and more complex marketplace models using Adyen for Platforms. You’ll learn how to:
By following these steps you’ll have a robust, production-ready Adyen integration that scales as your business grows.
Adyen is a unified payments platform that lets merchants accept payments online, in-app, and in-store. Key benefits include:
With “one integration, one API, one platform,” Adyen streamlines global payments and risk management, making it an ideal partner for Shopware merchants eyeing scalability.
Before diving in, make sure you have:
Having these in hand will make the integration process smooth and avoid mid-setup interruptions.
There are three main ways to install the Adyen plugin: via Shopware Admin, Composer, or manual upload. We’ll start with the GUI approach, suitable for most merchants.
cd /path/to/shopware
composer require adyen/adyen-shopware6
bin/console plugin:refresh
bin/console plugin:install --activate AdyenPayments
bin/console cache:clear
Download the ZIP from Adyen’s GitHub repository, then in Shopware admin Extensions → Upload Extension, select the ZIP file. Install and activate as above.
Regardless of method, after activation, you’ll see new payment methods under Settings → Shop → Payment.
Once installed, click Configure on the Adyen Payments plugin entry.
Save to persist credentials. Plugin will store them securely in Shopware’s configuration.
Review all toggles and adjust based on your business needs, then hit Save.
To surface Adyen methods in your storefront:
Log into your Test Adyen account, navigate to Account → Payment Methods, and ensure the selected methods are enabled for your merchant account. Methods disabled here will not appear in checkout, regardless of Shopware settings.
var/log/adyen_shopware.log
or
prod.log
for debug details.| Problem | Solution |
|---|---|
| Payment Methods Missing | Verify activation in Shopware and enable methods in Adyen’s CA |
| Card Fields Blank | Check Client Key and allowed origins—ensure your domain is listed |
| Invalid API Key/Merchant | Double-check credentials and roles (Checkout Webservice) in Adyen |
| Webhooks Not Updating Orders | Confirm webhook URL (/adyen/notification) and Basic Auth match plugin config; verify HMAC key is correct |
| Failed Test Payments | Ensure you’re in Test mode with Test keys; test cards won’t work in Live mode |
How are refunds handled?
In Adyen Dashboard: Issue partial/full refunds; webhooks update Shopware orders.
In Shopware Admin: For plugin versions ≥3.1, click Refund on the order view to trigger a refund API call.
Does the plugin cost anything?
The Adyen plugin is free. Adyen’s processing fees (percentage + fixed fee) apply per your contract and are handled outside Shopware.
Can I add surcharges?
The plugin doesn’t support surcharges out of the box. Consult local regulations before adding any fees, and consider custom development if allowed.
What order statuses does Adyen use?
Open: Awaiting payment.
Paid: Successful authorization.
In Progress: Asynchronous or pending 3DS.
Failed/Canceled: Refused payments.
Refunded: After successful refund.
Can I update keys without downtime?
Generate a new key in Adyen, update the plugin config, save, and test. Changes apply instantly; you can do this during low-traffic periods.
Does Adyen support installment plans?
Yes—enable BNPL methods like Klarna in your Adyen Merchant Account, then activate them in Shopware’s payment methods.
