README

Buckaroo for WooCommerce

About · Requirements · Installation · Upgrade · Configuration · Payment methods · Support · Contribute

About

WooCommerce is an open source e-commerce plugin for WordPress, used by shops of every size from small stores to large retailers.

The Buckaroo plugin for WooCommerce connects your shop to the Buckaroo payment gateway, so you can start accepting payments within minutes. Buckaroo is a Dutch Payment Service Provider. The plugin is free to download and every payment method it offers is SEPA proof.

Card payments run through Hosted Fields, which keeps the card entry inside your own checkout instead of redirecting the customer away. Express payment buttons can be placed on the product, cart and checkout pages.

Full plugin documentation on docs.buckaroo.io

Requirements

Requirement	Supported versions
WordPress	5.3.18 up to 7.0
WooCommerce	5.0 up to 11.0.0
PHP	8.0 or higher

You also need a Buckaroo account. Don't have one yet? Request an account.

Installation

The quickest route is straight from the WordPress plugin directory:

Sign in to your WordPress admin and go to Plugins → Add new.
Search for Buckaroo and open the Buckaroo Woocommerce Payments Plugin.
Click Install now, then Activate.
Buckaroo now appears in the left-hand admin menu.

Installing manually from a .ZIP file

Go to the releases page and download the .ZIP file of the latest version.
In your WordPress admin, go to Plugins → Add new → Upload plugin and select the .ZIP file.
Click Activate next to the Buckaroo plugin.

Upgrade

WordPress notifies you when a new version is available. Go to Plugins and click Update now on the Buckaroo plugin, or enable automatic updates.

Tip

Always test an upgrade on a staging environment first and check the release notes for breaking changes.

Configuration

After activating the plugin, select Buckaroo in the left-hand menu of your WordPress admin to open the general plugin settings.

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.

The settings page has an Automatic Configuration button that checks which Buckaroo subscriptions are active on your account and configures the matching payment methods for you.

Step-by-step instructions: Configuring the WooCommerce plugin

Payment methods

The plugin supports the following payment methods. Each one can be enabled or disabled individually and switched between live and test mode.


Alipay	Apple Pay	Bancontact
Bank Transfer	Belfius	Billink
Bizum	Blik	Credit and debit cards
EPS	Giftcards	iDEAL / Wero
In3	KBC	Klarna
MB Way	Multibanco	Pay by Bank
PayPal	PayPerEmail	Przelewy24
Riverty	SEPA Direct Debit	Swish
Trustly	Twint	WeChatPay
Wero

Important

All supported methods appear in the WordPress admin, but you need an active Buckaroo subscription for a method before you can offer it in your checkout.

Support

Having trouble? Work through this list before reaching out:

Check the frequently asked questions.
Confirm you are on the latest release.
Enable debug mode in the plugin settings and reproduce the issue. Logs can be stored in a file, in the database, or both.
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 WordPress version, WooCommerce 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

Contribute

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.

Versioning

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.}

buckaroo / woocommerce

Maintainers

Package info

Statistics

Security