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: http://servicedesk.tig.nl/hc/nl/articles/218518037
If you have any questions regarding the extension, please contact the TIG Servicedesk.
|Phone||(+31) 030 – 711 50 50|
|Buckaroo Plaza||Buckaroo Payment Plaza: http://plaza.buckaroo.nl|
- Composer installation
- Extension activation and updates
- File access rights
- Remove static files
- Flush cache and reindex
- Update the extension
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:
1.5. Remove static files
Depending on your webshop configuration, empty following static files directories: Cd
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/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
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.
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: http://servicedesk.tig.nl/hc/nl/articles/218517967
In the Merchant key field enter your Buckaroo Merchant key. On this page is described where you can find the Merchant key field: http://servicedesk.tig.nl/hc/nl/articles/218003018
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: http://servicedesk.tig.nl/hc/nl/articles/218517837
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: https://servicedesk.tig.nl/hc/nl/articles/219601708
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.
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: https://confluence.tig.nl/x/zYWC
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: http://devdocs.magento.com/guides/v2.0/install-gde/system-requirements.html
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 https://servicedesk.tig.nl/hc/nl/articles/218003338.
You can sign up as a watcher on this page so you receive updates when something changes. Need support with the Buckaroo extension? Please send an email to firstname.lastname@example.org 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 email@example.com.
Want to stay up-to-date?
You can sign up as a watcher on this page so you receive updates when something changes.
Need support with the Buckaroo extension? Please send an email to firstname.lastname@example.org 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 email@example.com.