About · Requirements · Installation · Upgrade · Configuration · Payment methods · Support · Contribute
Odoo is an open source suite of business applications, including eCommerce, accounting, inventory and CRM.
The Buckaroo app for Odoo connects your webshop to the Buckaroo payment gateway, so you can start accepting payments within minutes. Buckaroo is a Dutch Payment Service Provider. The app plugs into Odoo's payment framework and runs on Odoo.sh and self-hosted installations.
Important
This is the official Buckaroo app, published as payment_buckaroo_official. Odoo also ships a built-in payment_buckaroo provider, which is maintained by Odoo and covers only a limited set of payment methods. Install this app to use the full range of methods listed below.
Full plugin documentation on docs.buckaroo.io
| Requirement | Supported versions |
|---|---|
| Odoo | 19.0 |
| Editions | Community and Enterprise |
| Hosting | Odoo.sh and self-hosted |
You also need a Buckaroo account. Don't have one yet? Request an account.
Note
Odoo Online is not supported, because that platform does not allow custom modules to be installed. Use Odoo.sh or a self-hosted installation instead.
Download the module from the Odoo Apps store, or clone it from this repository:
git clone --branch 19.0 https://github.com/buckaroo-it/Odoo.gitThen add the module to your database:
Self-hosted — copy the module into your addons path and install the Python dependencies:
cp -r Odoo/payment_buckaroo_official /path/to/odoo/addons/
pip install -r Odoo/requirements.txtRestart the Odoo service afterwards.
Odoo.sh — commit the payment_buckaroo_official folder into your project repository and add the contents of requirements.txt to your project's requirements.txt, then let the build complete.
Finally, in Odoo go to Apps, click Update Apps List, search for Buckaroo and click Activate.
Replace the module folder with the latest version, then upgrade it. On Odoo.sh, commit the new version and let the build run. On a self-hosted database, run:
./odoo-bin -d YOUR_DATABASE -u payment_buckaroo_official --stop-after-initTip
Always test an upgrade on a staging database first and check the changelog for breaking changes.
In Odoo, go to Invoicing → Configuration → Payment Providers (or Website → Configuration → Payment Providers), open Buckaroo and set its state to Enabled or Test mode.
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.
Push messages also need to be enabled in Buckaroo Plaza so Odoo is notified of the payment result.
Step-by-step instructions: Configuring the Odoo app
The app 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 Odoo, 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.
- Reproduce the issue with the provider in test mode and check the Odoo server log.
- 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 Odoo version, app version, hosting type, 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 branch matching your Odoo version.
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.