A ready-to-sell payment gateway for Magento 2 (Adobe Commerce and Magento Open Source).
Accept the payment methods your customers expect in the Netherlands, Belgium, Germany, France and beyond.
About · Requirements · Installation · Upgrade · Configuration · Payment methods · Additional modules · Support · Contribute
Magento is an e-commerce platform owned by Adobe, available as Magento Open Source (free, self-hosted, written in PHP) and Adobe Commerce (the paid, cloud-hosted edition). Around 150,000 merchants worldwide run on the platform.
The Buckaroo plugin for Magento 2 connects your store to the Buckaroo payment gateway, so you can start accepting payments within minutes. Buckaroo is a Dutch Payment Service Provider and an Adobe Silver Technology Partner.
Beyond payments, the plugin ships with extras such as Google Analytics tracking and Second Chance, which sends reminder e-mails to customers who did not complete their payment.
Full plugin documentation on docs.buckaroo.io
| Requirement | Supported versions |
|---|---|
| Magento | 2.4.7 up to 2.4.9 |
| PHP | 8.1 up to 8.5 |
| Composer | 2.x |
You also need a Buckaroo account. Don't have one yet? Request an account.
Note
Older Magento and PHP versions may still work, but are no longer tested or supported. We recommend running a supported combination as listed in the Adobe system requirements.
We recommend installing the plugin with Composer — it is the easiest way to install, update and maintain.
Run the following commands from your Magento 2 root folder:
composer require buckaroo/magento2
php bin/magento module:enable Buckaroo_Magento2
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
php bin/magento cache:flushInstalling a specific version
composer require buckaroo/magento2:^2.0All released versions are listed on the releases page.
composer update buckaroo/magento2
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
php bin/magento cache:flushIf your store runs in production mode, make sure setup:di:compile and setup:static-content:deploy are executed after the upgrade.
Tip
Always test an upgrade on a staging environment first and check the release notes for breaking changes.
After installation, configure the plugin in the Magento admin under Stores → Configuration → Sales → Buckaroo.
You will need your Store key and Secret key, which you can find under API credentials in Buckaroo Plaza.
Step-by-step instructions: Configuring the Magento 2 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 Magento admin, but you need an active Buckaroo subscription for a method before you can offer it in your checkout.
The Buckaroo Magento 2 plugin can be extended with the following modules:
- Hyvä Checkout — payment support for the Hyvä Checkout.
- Hyvä React Checkout — payment support for the Hyvä React Checkout.
- GraphQL — payment support for headless setups via GraphQL.
More details: additional modules documentation.
Having trouble? Work through this list before reaching out:
- Check the knowledge base and FAQ.
- 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.
Still stuck? Contact us and include your Magento 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 develop 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 on the releases page.
Made with care by Buckaroo.
This document is subject to change; typos and language errors are possible.