Configuration

Configuring the Buckaroo plugin for Magento 2

A Buckaroo account is required to do test or live transactions with the Buckaroo plugin for Magento 2. Below you can find the configuration steps:

1. Go to the Buckaroo plugin in Magento 2

• Sign in to your Magento 2 backend.
• Go to Stores → Configuration in the left main menu.
• Within the next submenu, go to → Sales and select the Buckaroo logo to access the plugin settings.

2. Go to the settings

• Within the next submenu, go to → Sales and select the Buckaroo logo to access the plugin settings.

3. Fill in the settings below

3.1 Credentials

Enabled

• This setting lets you control the Buckaroo plugin mode, enabling or disabling the plugin.

Store key

• Enter your Buckaroo Store Key (Previously this was also known as the Merchant key).
• This key is unique for each store, allowing you to track transactions per store.
• You can find it in the Buckaroo Plaza → Settings → API Keys.

Secret key

• Enter your Buckaroo Secret Key.
• This key is unique for your entire Buckaroo account.
• You can also find the secret key in the Buckaroo Plaza at Settings → API Keys.

Transaction label

• Enter a transaction description so that your customers will recognize the payment on their bank statement.
• We advise to use a value that contains for example the webshop name for better recognition.
• You can use our static tags like:

Invoice handling

• Choose when the invoice should be generated.
• Options: upon successful payment or when creating a shipment.

Buckaroo payment fee tax class

• If you have configured a payment fee for some of the payment methods, then please choose the correct payment fee tax class here.

Save config

• Before proceeding with the certificate (label), please save the configuration by pressing the "Save Config" button.

Advanced configuration

❗️

Warning

These settings are intended only for advanced users. Modifying the default configuration may disrupt workflows and reduce the performance of Buckaroo payment methods. Proceed with caution—changes are made entirely at your own risk.

Advanced settings examples

• Modifying payment statuses
• Adjusting redirect URLs
• Various debugging settings
• Enabling the "Keep Cart Alive" mode (restores the cart when a consumer uses the back button in the browser)

Refund Configuration

Navigate to the Refunding tab to configure the handling of refunds.

Refund settings:

• Enabled: Determines whether refunds should be sent from Magento to Buckaroo.
• Accept Payment Plaza Refunds in Magento: Determines how manual refunds initiated from the Buckaroo Plaza should be managed.
  • If Magento is solely used for stock management and no monetary refunds need to be processed, disable this option.
  • If only monetary refunds are required and Magento is primarily used as a stock system, manual refunds from Buckaroo should be ignored.
  • In most scenarios, enable both functions to ensure close alignment between the two systems.