Common questions about the Buckaroo extension for Shopware 6. Select a question to expand the answer.

If something is not working as expected, Troubleshooting covers the common failures and how to diagnose them.

Getting started

Does the extension cost anything?

The extension is free to install and use. Your Buckaroo agreement covers what you pay for processing payments.

Should I install with Composer or from the Shopware Store?

Composer is recommended, because updating becomes a single command. The Store route works if you would rather not use the command line. See Installation.

Which Shopware versions are supported?

The supported Shopware, PHP and Composer versions are listed on the repository and with each release, since they change as new versions arrive.

Do I need to rebuild the administration after installing?

No. The extension ships pre-built administration assets, so there is no build command to run.

Do I have to configure every sales channel separately?

Yes. Credentials, method settings, fees and express buttons are all saved per sales channel. This is useful when channels should behave differently, and it is the most common cause of something working in one place and not another.


Payment methods

What is the difference between the two card options?

Grouped cards is the Hosted Fields option: one card field in your own checkout, with the scheme detected from the number, and it needs a client ID and client secret. Credit and debit cards lists each scheme separately and takes the customer away to pay. Enable one, not both.

Do customers leave my checkout to pay by card?

That depends which card method you enabled. Grouped cards uses Hosted Fields, so details are entered in your own checkout. Credit and debit cards takes the customer away to complete the payment. Other methods redirect where the method itself requires it. See Payment methods.

Why does a method I enabled not appear at checkout?

Usually because it has not been assigned to that sales channel under Sales Channels. Shopware will not offer an unassigned method however the extension is configured. See Troubleshooting.

Can I charge the customer a fee for a payment method?

Yes, as a fixed amount or a percentage, set per method. Check that a surcharge is permitted for the methods you use before switching this on. See Payment methods.

Can I put a payment button on my product pages?

Yes, for Apple Pay, Google Pay and PayPal Express. Each can appear on the product, cart and checkout pages, and every placement is off by default. See Express checkout.

Why is the Apple Pay button not showing?

Most often because the browser or device does not support Apple Pay. Otherwise, check your Buckaroo Guid is filled in and that the button is switched on for the page you are looking at.

Can I accept giftcards?

Yes, including your own giftcard brands. The customer selects the giftcard at checkout and is taken to the Buckaroo hosted payment page to enter the card details. See Payment methods.

What happens if a giftcard does not cover the full order amount?

The remainder is paid with a second payment method, chosen by the customer on the Buckaroo hosted payment page. Only methods you have selected in the giftcard settings are offered, so configure at least one or two popular methods alongside the giftcards themselves.

Orders and payments

What does authorising a payment mean?

The money is reserved rather than collected. Nothing reaches your account until the payment is captured, either manually from the order or automatically when you mark the delivery as shipped. An authorised order is not a paid order.

Can I refund from Shopware?

Yes, from the Buckaroo panel on the order: the grand total, a custom amount, or selected line items. Use that panel rather than Shopware's own refund handling, which updates your administration without telling Buckaroo. See Order management.

Can I refund more than once against the same order?

Yes, up to the amount originally paid.

Can I send a payment link for an existing order?

Yes. Create paylink in the Buckaroo panel produces a link for that order, which suits phone orders or a payment that failed the first time.

Do I need to configure a push URL?

No. The extension handles this. Your store does need to be reachable from the internet, and if it sits behind a firewall, Buckaroo's push addresses need to be allowed. See Push messages.


Configuration and operations

Which language do customers see when they pay?

It follows the language setting, which defaults to the customer's browser language. You can also base it on their billing country, use the sales channel default, or fix it to one language. See Configuration.

Will upgrading lose my settings?

No. Updating the extension keeps your configuration. Uninstalling is different, and removes it.

Where do I report a bug?

As an issue on the GitHub repository, with your Shopware, extension and PHP versions plus the relevant log lines. For anything affecting live payments, contact support instead. See Contact us.


Did this page help you?