Article Summary

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

        1. Sign in to your → Magento 2 backend.
        2. Go to → StoresConfiguration in the main menu of Magento.
        3. Then go to the Sales submenu and click on the → Buckaroo logo to open the plugin settings.
        4. Fill all required information at the General Configuration and account information settings page.
          A description of each needed credential is provided below, see the required information to connect the plugin with your Buckaroo account.


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

        1. Enabled:
          Set this option to → Live to enable the Buckaroo plugin.

        2. Secret key:
          Can be set in the Buckaroo Plaza at → ConfigurationSecuritySecret Key.
          Note: the secret key may only contain numbers and letters!
          Copy the Secret key once you've created it in the Buckaroo Plaza. If you already have a secret key for your Buckaroo account, then you can copy it.

        3. (Merchant) key (also known as the website key):
          The merchant key can be found in the Buckaroo Plaza under → My BuckarooWebsites. Using the filter button at the top right, you can then switch between multiple websites (if multiple websites are linked within the same Buckaroo account).
          Select the website to be linked here. Then in the tab → General you will find the key.

        4. (Merchant) GUID:
          The GUID can be found in the Buckaroo Plaza at → My BuckarooGeneral. The Guid will be displayed at the top of the page.
          It is a pretty long code with letters and numbers.

        5. Transaction label:
          This is the transaction description. We advise to fill in your website name here.
          This so customers will recognize this since this will also be showed on their bank statement.

        6. Certificate label:
          This is the name that will be given to the certificate that you'll have to upload in the next step. You can fill in "Buckaroo" here for example.

        7. Upload your Buckaroo private key certificate:
          You can create a certificate in the Buckaroo Plaza at → ConfigurationSecurityCertificates.
          A certificate can be created with the → Actions button on this page.
          Please note that the certificate is downloaded directly in the browser. Save this file properly so that it can be found later.

          After creating a certificate, the certificate must be uploaded in your Magento backend at the → Certificate Management Tab which you'll find lower in the Buckaroo plugin settings.
          *When the certificate is uploaded it will be selectable in the general plugin configuration.

        8. Certificate thumbprint:
          Can be found in the Buckaroo Plaza at → ConfigurationSecurityCertificates.
          The fingerprint can only be found after a certificate has been created. After creating a certificate, the fingerprint will be visible in the overview of all certificates.
          Now save the configuration, otherwise you are not able to select the correct Certificate file.

        9. Certificate file:
          Select the certificate file that you've uploaded before. You can recognize the certificate with the given certificate label (name). Now save the configuration again, so all credentials are correctly filled in.

        Advanced configuration

        In the Buckaroo plugin there is also a advanced configuration section.

        These options are only intended for expert users. Tampering with the default settings may negatively affect the workflow and performance of all Buckaroo payment methods. Use at your own risk

        Some examples of settings that you can find here are:
        • Changing payment statuses.
        • Changing the redirect URL's.
        • Several debugging settings.
        • Keep cart alive mode (Optional will restore the cart when consumer use back button).

        Refund configuration

        Under the tab → Refunding you can set how refunds should be handled.

        The setting "Enabled” determines whether refunds are sent from Magento to Buckaroo.

        The setting “Accept Payment Plaza refunds in Magento” determines how manual refunds from the Buckaroo Plaza should be handled.

        If Magento is only used for stock management and no money actually needs to be refunded to the consumer, the refund option must be disabled.

        Conversely, if only money needs to be refunded (for example with a partial refund), but Magento is used purely as a stock system, manual refunds from Buckaroo should be ignored.

        In most cases, however, both functions are set to active, so that both systems run as closely as possible.

        Payment method configuration

        For the payment method configuration settings, please go to StoresConfiguration (in the left main menu of Magento.

        At the Sales sub menu click on → Payment Methods.

        Then there is a separate tab for each payment method. For each payment method you can set whether the method is active, whether it creates live or test transactions, the name of the payment method in the checkout and whether costs should be charged if the consumer chooses for a specific method.


        Haven't installed the Buckaroo plugin yet? Then please check out our installation page.

        Please contact Buckaroo support if you have any technical questions.  

        Our telephone number and contact details of other departments can be found in the Buckaroo Payment Plaza under "Contact details" at the bottom left of the screen.

        Was this article helpful?