Page tree
Skip to end of metadata
Go to start of metadata


This manual describes the functionality of the Buckaroo Magento 2 extension. The Buckaroo Magento 2 extension is developed by TIG for Buckaroo. The extension makes it possible for Merchants to pay via the Buckaroo Payment Service Provider in Magento.

For the installation of the extension in Magento 2 we use Composer as the package manager.
For more information about the installation of composer please find this knowledge base article:

If you have any questions regarding the extension, please contact the TIG Servicedesk.



Phone(+31) 030 – 711 50 50
Buckaroo PlazaBuckaroo Payment Plaza:





SFTP Installation
Technical requirements
Release notes

1. Installation 

1.1. Back-up 

We strongly advise to install and update the extension on a staging environment first and make a back-up of your webshop prior to the installation.

1.2. Composer installation Login via SSH and execute the following commands via the command line:

  • composer require tig/buckaroo

1.3. Extension activation and updates

Execute the following commands via the command line:

  • php bin/magento module:enable TIG_Buckaroo
  • php bin/magento setup:upgrade

1.4. File access rights

Depending on the operating system, make sure the just added files have the correct access rights so that the web server can access and execute the files correctly.

The composer command can be executed by the logged in user on the server which is sometimes not the same as the user of the web server. The files created by composer can’t be read by the web server which can lead to unexpected behaviour.

Composer will install the files in:

  • vendor/tig/buckaroo/

1.5. Remove static files

Depending on your webshop configuration, empty following static files directories: Cd

  • pub/static/frontend/
  • pub/static/adminhtml/
  • pub/static/_requirejs/

1.6. Flush cache and reindex

Flush your Magento cache using the following command:

  • php bin/magento cache:flush

Depending on your configuration, make sure the following directories are emptied:

  • var/cache
  • var/page_cache
  • var/generation
  • var/di (if this folder exists)

Execute the following command via the command line to force a re-index:

  • php bin/magento indexer:reindex

The installation is now completed. 

Update the extension

To be able to make use of the latest features and bugfixes you should update the extension frequently. To do this you have to execute the following commands and flush your Magento cache.

  • composer update tig/buckaroo
  • php bin/magento setup:upgrade

2. Configuration 

Login at the Magento backend and go to Stores → Conguration → Sales → Buckaroo.

2.1. General configuration and account information 

By default is the extension is deactivated in the Magento back-end. First enable the test mode in the extension.

In order to continue, you need the Buckaroo account details. Please contact Buckaroo if you do not have these details.

Security key
Enter your Buckaroo Security key in the security key field. On this page is described where you can find the security field in the Buckaroo Payment Plaza:

(Merchant) key
In the Merchant key field enter your Buckaroo Merchant key. On this page is described where you can find the Merchant key field:

Certicate label
Enter a name for the certificate that you are going to upload in the next step. For example ‘webshop name certificate’.

Upload your Buckaroo private key certicate
Upload here your Buckaroo certificate. You can find on this page where you can generate your Buckaroo private key certificate:

Certificate file 
Select which certificate you want to use.
If desired, you can now change settings in the advanced settings tab.

Configure now your Buckaroo Payment Plaza. You can find the correct settings on this page:

De configuratie in Buckaroo Payment Plaza dient u ook aan te passen. Op deze pagina beschrijven welke stappen u daarvoor dient te nemen: 

2.2. Buckaroo payment methods

After installation, for security reasons by default all the payment methods are disabled. In this menu you can select which payment methods you want to activate.
Note: The Afterpay B2B option is unavailable and is scheduled for a future release.

2.3. Refunding

Select if you want use refunds and whether you want to receive refunds from within the Buckaroo Payment Plaza.
The Buckaroo Magento 2 extension is now installed and configured.
Please do not forget to switch to live mode when going live with the webshop.

3. SFTP Installation 

Can I upload the extension also via SFTP?
Yes, we explained (in Dutch) how to do this on this page:

4. Technical requirements 

In order to use the Buckaroo Magento 2 extension, you need to comply with the minimal technical requirements as stated by Magento on this page:

On this page is explained which Magento version(s) can run the extension.

5. Release notes

You can find the extension’s release notes on our Knowledge Base.
This list is the most up-to-date and will be updated when we release new versions of the extension.
You can find this list on

Need support with the Buckaroo extension? Please send an email to or call Buckaroo on phone number 030-711 5000.

Do you have feedback? We would like to hear from 020-2181001 or by e-mail at

  • No labels