On this page, we'll guide you through configuring the Buckaroo app in just a few steps.

1. Access the Ecwid backend: Start by logging in to your Ecwid store's backend.
   Navigate to Apps and then My Apps.
2. Open the Buckaroo Payments app: In My Apps, locate the Buckaroo Payments app.
   Click on the button next to it to open the app. If you don’t see it listed yet, refer to our installation guide on the installation page on how to install the app.
3. Begin on the getting started page: The app will open on the Getting Started page, where you’ll find an overview of steps to connect your Buckaroo account. Next, go to General Settings in the menu to proceed.
4. Configure the operating mode: Choose the mode in which you want to operate: Test Mode for testing purposes or Live Mode to start receiving real payments.
5. Enter Buckaroo API keys: In the General Settings section, enter your Buckaroo website key and secret key. You can find these keys in the Buckaroo Plaza. If prompted, log in to Buckaroo Plaza to access this page.
6. Fill in the Transaction Description: Enter a description for your transactions. This will appear on the customer's bank statement and in the Buckaroo Plaza, so we recommend using something easily recognizable, such as your store name together with our {order_number} tag to display their order number. You can also set a separate description for debit and credit (refund) transactions.
7. Save your settings: After completing the previous steps, click the Save button to apply your changes.

Payment method settings

To configure the payment methods please follow the steps below.

1. In the Buckaroo app go to Payment method settings in the menu of the app.
2. Below each available payment method there you'll see the text Configure which will link to the configuration options for that specific payment method. Click on it for options like iDEAL, for example.
3. On the payment method configure page you'll be able to select the mode of that specific payment method, test or live mode. Click on the desired option/mode.
4. Save your settings: After completing the previous steps, click the Save button to apply your changes.
5. The payment method should now appear in your checkout, ready for live transactions or testing, based on the mode you selected.

Additional payment method settings

Here are some additional settings available for configuring payment methods within the app:

• Minimum and maximum transaction amounts: When setting up a payment method, you can specify minimum and maximum transaction amounts to control when it appears in the checkout.
• Country-specific availability: You can choose to enable payment methods only for specific countries.
• Refunds: In the app menu, the Refunds section allows you to process refunds directly within the Buckaroo app.
• Method-specific options: Certain payment methods have unique settings. For example, with card payments, you can select which card brands to activate, as some brands may require a specific subscription to be available in your Buckaroo account.