Configuration

A Buckaroo account is required to perform test or live transactions with the Buckaroo plugin for Magento 2. Follow these steps to configure the plugin:

1. Sign In to Magento 2 Backend:
   1. Navigate to Stores → Configuration in the main menu of Magento.
   2. Within the Sales submenu, select the Buckaroo logo to access the plugin settings.
2. Complete General Configuration:
   1. Fill out all necessary information on the General Configuration and Account Information page.
   2. Refer to the descriptions below for each required credential to establish the connection between the plugin and your Buckaroo account.

Required Credentials:

3. Enabled: Set this option to "Live" to enable the Buckaroo plugin.
4. Secret Key:
   1. Create a secret key in the Buckaroo Plaza at Settings → Secret Key.
   2. The secret key should only contain numbers and letters. Copy the secret key once it's created.
5. Merchant Key:
   1. Find the merchant key in the Buckaroo Plaza under Settings → Websites.
   2. Use the filter button to switch between multiple websites (if applicable).
   3. Select the desired website and go to the General tab to locate the key.
6. Merchant GUID:
   1. Retrieve the GUID from the Buckaroo Plaza at My Buckaroo → General.
   2. The GUID is displayed at the top of the page and consists of a combination of letters and numbers.
7. Transaction Label:
   • This represents the transaction description. We recommend using your website name to ensure recognition by customers, as it will also appear on their bank statements.
8. Certificate Label:
   1. Assign a name to the certificate that will be uploaded in the next step, such as "Buckaroo".
9. Upload Your Buckaroo Private Key Certificate:
   1. Generate a certificate in the Buckaroo Plaza at Settings → Certificates.
   2. Create the certificate using the Actions button on the page.
   3. Save the file properly for future reference.
   4. Upload it in the Certificate Management tab in your Magento backend.
10. Certificate Thumbprint:
    1. Retrieve the thumbprint from the Buckaroo Plaza at Settings → Certificates.
    2. The thumbprint is only visible after creating a certificate.
11. Certificate File:
    1. Select the certificate file that was previously uploaded. Identify the certificate by its given label (name).

❗️

Remember to Save

To ensure all the necessary information is saved accurately.

Advanced Configuration

❗️

Expert Notice

It is important to note that altering the default settings without proper knowledge may have adverse effects on the workflow and performance of all Buckaroo payment methods. Therefore, these options should be used 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.

Payment Method Configuration

To access the payment method configuration settings, follow these steps:

1. Navigate to Payment Methods:
   1. Go to Stores → Configuration in the left main menu of Magento.
   2. Click on the Sales submenu.
   3. Select Payment Methods.
2. Customize Settings for Each Payment Method:

• Enable Payment Method: Enable or disable the payment method by setting it to "LIVE", "TEST", or "OFF".
• Frontend Label: Specify the name of the payment method as it appears during checkout.
• Frontend Subtext: Optionally, provide a subtext to be displayed below the payment method during the checkout process.
• Frontend Subtext Style: Select the desired font style for the subtext (Regular, Italic, or Bold).
• Frontend Subtext Color: Select the desired frontend subtext colour.
• Frontend Sort Order: Specifies the sorting order of payment methods during the checkout process.