Configuration

A Buckaroo account is required to do test or live transactions with the Buckaroo plugin for WooCommerce. Please be aware that WooCommerce is also required besides WordPress. Below you can find the configuration steps:

  1. Sign in to your → WordPress backend.
  2. Go to the → Buckaroo plugin in the main menu on the left side.
  3. On the → General Buckaroo plugin page, you'll find the configuration settings. Below each settings field there is an explanation of where to find these credentials in the Buckaroo Plaza (login with your account).
Woocommerce_configuration_settings

The following information is required to connect the plugin to your Buckaroo account

  1. Website key:

The merchant key can be found in the Buckaroo Plaza at → Settings → Websites. Using the filter button at the top right, you can then switch between multiple websites (if multiple websites are linked within the Buckaroo account).
Select the website to be linked here. Then in the tab → General you will find the key.

  1. Secret key:

Can be set in the Buckaroo Plaza at → Settings → Secret Key.

❗️

Note

The secret key may only contain numbers and letters!

  1. Fingerprint:

Can be found in the Buckaroo Plaza at → Settings → Certificates.
The fingerprint can only be found after a certificate has been created. After creating a certificate, the fingerprint will be in the overview of all certificates. Below are the instructions to create a certificate (see below).

  1. Upload Certificate:

You can create a certificate in the Buckaroo Plaza at → Settings → Certificates.
A certificate can be created with the → Actions button on this page. After creating a certificate, the certificate must be uploaded in the Buckaroo plugin for WooCommerce in the settings.

❗️

Note

Please note that the certificate is downloaded directly in the browser. Save this file properly so that it can be found later.

  1. Select Certificate:

Select the certificate in the plugin settings that you've uploaded in the previous step.

  1. Save the entered data:

Now save the entered data. All basic settings are now ready for the connection with Buckaroo. Now you can still change the settings for each payment method.


Push settings to update the order status automatically in WooCommerce.

  1. Login with your Buckaroo account on → Plaza.buckaroo.nl
  2. Go to → Settings → Websites and select the website with the filters dropdown on the right side.
  3. Then go to the settings tab named → Push settings.
  4. The checkbox → Enable Push Response, must be checked 🗹.
  5. The fields → Push URL Success and → Push URI Failure must both be filled with a URL of your website.This is: https://[base URL website]/?wc-api=WC_Push_Buckaroo. The base URL of your website will in most cases follow the form of 'www.yourwebsite.com'.

📘

Note: There are exceptions to this.

The most common exceptions are 'www.yourwebsite.com/index.php' and 'www.yourwebsite.com/NL' or a combination of both.
To find out what base URL your website uses, go to the front page of your website and click on some links.
You always look at the URL of the page you are on. The part at the beginning of the URL that stays the same is your base URL.

Buckaroo_plaza_websites

❗️

Make sure

Make sure that the following PUSH settings are correctly as well:

  • HTTP-Method must be set to → POST
  • For → Push type choose → BPE3.0
  • Set the Push Content type to → httppost