About · Requirements · Installation · Upgrade · Configuration · Payment methods · Support · Contribute
Shopware is a modular online shop system developed in Germany since 2004, available both as open source software and in commercial editions.
The Buckaroo plugin for Shopware 6 connects your store to the Buckaroo payment gateway, so you can start accepting payments within minutes. Buckaroo is a Dutch Payment Service Provider and a certified Shopware Technology Partner.
Card payments run through Hosted Fields, which keeps the card entry inside your own checkout instead of redirecting the customer away.
Full plugin documentation on docs.buckaroo.io
| Requirement | Supported versions |
|---|---|
| Shopware | 6.5.8.0 up to 6.7.x |
| PHP | 8.2 or higher |
| Composer | 2.x |
You also need a Buckaroo account. Don't have one yet? Request an account.
Note
No administration rebuild is required. The plugin ships pre-built administration assets for all supported Shopware versions, so you do not need to run bin/build-administration.sh or any other build command after installing or updating.
We recommend installing the plugin with Composer. It is the easiest way to install, update and maintain.
Run the following commands from your Shopware 6 root folder:
composer require buckaroo/shopware6
ln -s ../../vendor/buckaroo/shopware6 custom/plugins/BuckarooPayments
bin/console plugin:refresh
bin/console plugin:install --activate BuckarooPayments
bin/console cache:clearInstalling from the Shopware Store
You can also install the plugin without Composer:
- Sign in to your Shopware 6 administration.
- Go to Extensions → Store and search for Buckaroo.
- Install the extension and activate it.
composer update buckaroo/shopware6
bin/console plugin:update BuckarooPayments
bin/console cache:clearTip
Always test an upgrade on a staging environment first and check the release notes for breaking changes.
Sign in to your Shopware 6 administration and go to Extensions → My extensions. Find the Buckaroo extension, make sure it is active, and press Configure.
You will need your Store key and Secret key, which you can find under API credentials in Buckaroo Plaza. The Store key is unique per store, the Secret key applies to your whole account.
To offer Apple Pay you also need your Buckaroo Guid, found in the Buckaroo Plaza under My Buckaroo → General.
Step-by-step instructions: Configuring the Shopware 6 plugin
The plugin supports the following payment methods. Each one can be enabled or disabled individually and switched between live and test mode.
Important
All supported methods appear in the Shopware administration, but you need an active Buckaroo subscription for a method before you can offer it in your checkout.
Having trouble? Work through this list before reaching out:
- Check the frequently asked questions.
- Confirm you are on the latest release.
- Enable debug logging in the plugin configuration and reproduce the issue.
- Verify that your push URL is reachable from outside your network. Buckaroo sends push messages from fixed IP addresses and ports, so make sure these are on your allow list. See push messages for the current list.
Still stuck? Contact us and include your Shopware version, plugin version, PHP version, the relevant log lines and the transaction key.
- Bug reports and feature requests: open an issue
- Technical support: support@buckaroo.nl
- Phone: +31 (0)30 711 50 50
- Gateway status: status.buckaroo.io
We really appreciate it when developers help improve the Buckaroo plugins. Please read our Contribution Guidelines before opening a pull request, and target the master branch.
Found a security issue? Please report it privately to support@buckaroo.nl instead of opening a public issue.
We follow semantic versioning (MAJOR.MINOR.PATCH):
- MAJOR — breaking changes that require additional testing and caution.
- MINOR — new functionality with limited impact.
- PATCH — bug fixes and hotfixes only.
All changes are documented in the changelog and on the releases page.
Made with care by Buckaroo.
This document is subject to change; typos and language errors are possible.