This guide helps store owners, developers, and agencies seamlessly integrate Unzer — a versatile European payment provider — into Shopware. It walks through each step, with clear instructions, structured sections, and mandatory screenshots to illustrate key parts of the implementation.
Unzer (formerly Heidelpay) is a European payment service provider, currently servicing tens of thousands of merchants. It supports a wide range of payment methods across Europe:
Why Unzer suits Shopware stores:
serialize_precision = -1
in php.ini. Shopware 5 requires PHP 7.2+.You can install the plugin via Composer or manually.
composer require unzerdev/shopware6
php bin/console plugin:refresh
php bin/console plugin:install --activate UnzerPayment6
php bin/console cache:clearcustom/plugins/UnzerPayment6
.cd custom/plugins/UnzerPayment6
and run
composer install --no-dev
.composer require unzerdev/shopware5Or manually place the unzipped folder into
custom/plugins/
, then activate via Plugin Manager.
Choose the mode per payment method (cards, wallets, invoice, etc.).
With Test mode enabled and sandbox API keys entered, proceed with test purchases.
| Issue | Symptoms / Fix |
|---|---|
| API authentication errors | “Invalid credentials” or payment failed → double-check keys match “Test” vs “Live” mode. |
| Missing payment methods | No Unzer methods listed at checkout → ensure currency / country enabled in both Shopware and Unzer backend. |
| CSP issues | Buttons or scripts don’t work → add Unzer domains to Content-Security-Policy allow-list. |
| Redirect failures | Users never return to shop → ensure HTTPS and no directory-level authentication. |
| Webhook sync issues | Order status not updating → re-register webhooks in settings; check API logs for failures. |
What if the Unzer connection fails?
Check API credentials, confirm sandbox vs live mode, re-register webhooks, verify HTTPS and firewall allowances, and clear plugin cache.
What fees does Unzer charge?
Typical fees are around 1.50 % + €0.20 per transaction, monthly fees from €19, and setup approx. €149. (Verify pricing in your merchant contract.)
How are refunds handled?
Initiate refunds in Shopware under Orders → Transactions (full or partial). This action also creates the refund in Unzer backend.
What if a payment method is unavailable?
Confirm the method is enabled in Unzer backend and Shopware settings, ensure you’re operating in a supported country / currency, and re-register webhooks.
How does Unzer Invoice Secured work?
It guarantees merchant payment regardless of eventual buyer default — ideal where payment risk must be mitigated.
