FAQ
Common questions about the Buckaroo app for Odoo. Select a question to expand the answer.
If something isn't working as expected, Troubleshooting covers the common failures and how to diagnose them.
Getting started
Does the app cost anything?
No. The app is free and open source. You pay Buckaroo's transaction fees on the payments you process. Licence details are on the GitHub repository.
Do I need a Buckaroo account before I can install it?
You can install the app without one, but you need an account and API keys to process any transaction, including test transactions. Sign up here. You can start testing while your application is reviewed.
What is the difference between Buckaroo Official and the Buckaroo provider that comes with Odoo?
Odoo ships a built-in Buckaroo provider (payment_buckaroo) that Odoo maintains itself, covering a limited set of payment methods.
Buckaroo Official (payment_buckaroo_official) is maintained by Buckaroo and is the app this documentation describes. It supports the full range of methods, plus express checkout, Hosted Fields, refunds from Odoo, authorise and capture, PayPerEmail and payment fees.
You don't need to uninstall the built-in provider. Install the official app and configure that one.
Can I use the app on Odoo Online?
No. Odoo Online does not allow custom apps to be installed. Use Odoo.sh or a self-hosted installation.
Which Odoo versions are supported?
Odoo 19.0, in both Community and Enterprise editions. Each Odoo version has its own branch in the GitHub repository, and the app version carries the Odoo version in its number.
Does the app work with Odoo Point of Sale?
No. The app extends Odoo's eCommerce checkout and invoicing. For in-store payments, see Point of Sale.
Payment methods
How do I add a payment method to my contract?
Contact your account manager or Buckaroo support. Some methods, such as PayPal and the Buy Now Pay Later providers, require separate onboarding with the provider.
Can I charge a fee for a specific payment method?
Yes. Each method has a Payment fee setting that takes a fixed amount or a percentage. The fee is added as its own order line, inherits VAT from the products on the order, and is shown to the customer in checkout. See Payment methods.
Whether you're allowed to charge a fee, and how much, depends on the payment method and the rules that apply to your business. That's yours to check.
Can I hide a payment method for small or large orders?
Yes. Set a Buckaroo Min Amount and Buckaroo Max Amount per method. Methods outside the range are hidden in checkout.
Both values are in the order currency, with no conversion applied, so one number applies across every currency you sell in.
Do I need PCI certification to accept cards?
Not with Hosted Fields or the redirect flow. In both cases card data goes directly to Buckaroo and never touches your server, which keeps you out of the heavier PCI scope.
Are recurring payments or saved cards supported?
No. The app does not store payment tokens, so it does not support saved cards, recurring charges or Odoo subscriptions billed automatically through Buckaroo.
Orders and payments
Do I need to configure a push URL?
No. The app sends the correct push URL with every transaction request, which overrides anything set in Plaza, so there is no URL to enter anywhere.
Two things do need doing: enable push messages for your store in Plaza under Settings → Stores → Push settings, and make sure Buckaroo's IP addresses can reach your server. See Connect your Buckaroo account.
Can I refund from Odoo, or do I have to use Plaza?
Refund from Odoo wherever you can. It creates the credit note and the refund together and keeps Odoo as your source of truth.
If you do refund in Plaza, the app records it in Odoo automatically as a refund transaction on the original payment. Never refund the same order in both systems, or you risk refunding the customer twice.
Can I do partial refunds?
Yes, for every method except Riverty. Create a credit note for the specific items or amount. Riverty refunds from Odoo must be for the full amount; use Plaza for a partial Riverty refund.
When is the customer actually charged for methods that use authorise and capture?
When you capture. Selecting Capture Transaction collects the money. Until then the amount is reserved but not taken. Authorisations expire, so capture as soon as you can ship.
Configuration and operations
Is there a per-method test mode?
No. Mode is set on the provider, and every enabled method follows it. That makes testing simpler than a per-method switch, but it also means you can't go live with one method while still testing another.
Can I use different Buckaroo stores for different websites?
Yes. The provider is scoped to a company, so you can add a Buckaroo Official provider per company with its own Store key. The Secret key is account-level and shared.
Which languages does the app support?
English, Dutch, German and French. The app follows the language the customer is browsing in.
How often should I update the app?
Apply patch releases promptly and review minor releases as they come. Because each Odoo version has its own branch, check app compatibility before you upgrade Odoo. See Releases and upgrading.
Support
Is support included?
Yes, for merchants with a Buckaroo account. Contact [email protected] or +31 (0)30 711 50 50.
Can I customise the app?
It's open source, so yes, though customisation makes upgrades harder to manage. Keep a record of your changes and follow Odoo's guidance on extending modules. If the change would benefit other merchants, consider opening a feature request on GitHub instead.
Where do I report a bug or request a feature?
Open an issue on GitHub. For a problem in a live shop, work through Troubleshooting first, then see Contact us.
How do I report a security issue?
Privately, to [email protected], rather than in a public GitHub issue.
Updated 3 days ago