Payment methods

Choose which payment methods to offer, and control when each one appears in checkout.

You will see every payment method the plugin supports in the WordPress admin, whether or not you can use it. A method only works in checkout if it's also active on your Buckaroo contract. If a method is enabled in WooCommerce but not on your contract, customers will see it and the payment will fail. Check your active methods in Buckaroo Plaza, or contact your account manager to add one.

Enable a payment method

  1. Go to WooCommerce → Settings → Buckaroo Settings → Payment Methods.
  2. Select the settings icon next to the method you want.
  3. Tick Enable/Disable.
  4. Set Transaction mode to Test or Live.
  5. Select Save changes.

The Payment Methods list shows each method's status as Active, Test or Inactive, along with the countries and currencies it supports, so you can see the state of your whole setup on one screen.

Apple Pay, Google Pay and PayPal can also show Not configured at the top of their own settings page. That means a required credential is missing and the method is hidden from customers. See Required credentials.

Rather than working through the list by hand, use Auto-configure on the General Settings page.
It reads your Buckaroo contract and enables the matching methods for you.
Read more about it at the documentation on how to connect your Buckaroo account.

Buckaroo plugin payment methods overview

Common settings per method

Most methods share the same set of options. These are what let you show the right methods to the right customers instead of showing everything to everyone.

SettingWhat it does
Enable/DisableWhether the method appears in checkout at all.
Transaction modeTest or Live, set per method.
TitleThe label shown in checkout.
DescriptionExplanatory text under the method name in checkout.
Payment feeA fixed amount, for example 1.50, or a percentage, for example 1%. Decimals use a dot.
Minimum order amount allowedHide the method below this cart total. Zero or empty means no limit.
Maximum order amount allowedHide the method above this cart total. Zero or empty means no limit.

The fee's tax class and whether it displays including or excluding VAT are set once for all methods under Configuration.

Order your methods by how your customers actually pay, not alphabetically. In the Netherlands, putting Wero at the top is worth real conversion. Method order follows WooCommerce's own payment gateway ordering under WooCommerce → Settings → Payments.


Available payment methods

The plugin supports the following payment methods:

For a complete overview of which methods are available in which country, see Overview per country.


Cards and Hosted Fields

Card payments can run in two modes, set by Credit and debit card method:

  • Redirect: the customer is sent to Buckaroo's hosted payment page to enter their card details.
  • Inline (Hosted Fields): the card form is embedded directly in your checkout using secure iframes. The customer never leaves your store, which converts better.

Hosted Fields keeps you out of PCI-DSS scope because the card data never touches your server. It needs a Hosted Fields Client ID and Client Secret, which you create in Buckaroo Plaza under Settings → Token registration. See Hosted Fields.

Hosted Fields requires HTTPS on your checkout. Without a valid certificate the inline card form will not load.

Credit and debit card flow sets whether the plugin sends a Pay or an Authorize request. Use Authorize to reserve the amount and capture it later. See Order management.

Card brands

Card payments cover Visa, Mastercard, American Express, Maestro, Visa Electron, V PAY, Carte Bancaire, Carte Bleue, Dankort, Nexi and PostePay.

Two settings control how they appear:

SettingWhat it does
Allowed providerWhich brands the customer can choose. Deselect a brand to hide it.
Show separate in checkoutWhich brands get their own entry in the checkout payment list, instead of sitting behind a single card option.

Showing a brand separately is worth doing where a brand carries recognition of its own in your market. Showing all eleven separately is not: it turns your checkout into a wall of logos.


Giftcards

Giftcards are entered in your checkout and applied against the order total, with the remainder paid by another method.

List of authorized giftcards controls which brands are accepted, as a comma-separated list of Buckaroo giftcard service codes. The default covers VVV Giftcard, Boekenbon, Boekenvoordeel, Fashioncheque, YourGift and Webshop Giftcard.

The codes here are Buckaroo service names, not display names. If you add a brand, take the exact code from your Buckaroo contract. A typo silently drops that brand rather than showing an error.


Express checkout

Apple Pay, Google Pay and PayPal can appear as a fast-checkout button on the product page, the cart and the checkout, letting the customer skip the address forms. They tap the button, confirm their details in the wallet, and the order is placed.

Express payment buttons example for WooCommerce

The express settings have a new layout. Apple Pay, Google Pay and PayPal now share one structure, and some settings have new names. Your existing choices carry over when you update: the buttons look the same and appear on the same pages.

How the settings are laid out

Each express method has the same sections, in the same order:

SectionWhat's in it
No headingEnable/Disable, the method's credentials, Transaction mode, Payment fee and the Minimum and Maximum order amount allowed.
Method specific settingsWhere the express button appears, whether the method is also listed in checkout, and anything only that method has, such as Seller protection for PayPal.
Graphical settingsHow the button looks: Button style, Button type and a live Button preview.

Apple Pay and Google Pay have no Title or Description setting. PayPal keeps both, and puts its sandbox merchant ID under a separate Sandbox credentials heading.

Settings all three share

SettingWhat it does
Show the express button onThe pages that show the button: Product page, Cart page and Checkout page. Clear all three to hide the express button everywhere. This hides only the button, not the payment method.
Button styleThe colour of the button. The options differ per method, listed below.
Button typeThe wording shown on the button next to the wallet's own mark, such as "Buy with" or "Checkout". Plain shows the mark alone.
Button previewShows the button as customers will see it, and updates as you change the style and type, before you save. If the wallet's script can't load in your admin, the preview shows a message instead.

Express buttons have a fixed height so they line up with each other. There is no height or width setting.

Required credentials

Each express method needs its own credentials, and some are only needed for live payments.

MethodCredentialTest modeLive mode
Apple PayGUIDRequiredRequired
Google PayGateway Merchant IDRequiredRequired
Google PayGoogle Merchant IDNot requiredRequired
PayPalMerchant IDNot requiredRequired
PayPalSandbox merchant IDOptionalNot used

If a required credential is empty, the plugin shows an error when you save. The status at the top of the method's settings page reads Not configured, and the method is hidden from the checkout and from every express button until you fill it in. A value of 0 counts as empty, and that is what the GUID and Gateway Merchant ID fields start with.

The Payment Methods list doesn't show Not configured. A method with a missing credential still appears there as Active or Test. Open the method itself to see its real status.

Apple Pay

SettingWhat it does
GUIDYour Buckaroo GUID, from Plaza under My Buckaroo → General.
List as payment method in checkoutAlso offer Apple Pay in the checkout payment list, alongside the express button. Yes by default.
Button styleBlack, White or White outline. Black by default.
Button typePlain, Buy, Check out, Order, Book or Subscribe. Plain by default.

List as payment method in checkout is worth understanding. As a selectable payment method, the Apple Pay sheet only authorises the payment: billing and shipping come from the checkout form the customer already filled in. As an express button, the sheet supplies the address as well. Having both means customers can use Apple Pay whichever way they arrive at checkout.

Apple Pay is now shown across browsers rather than only in Safari.
On a browser without native support the customer can still complete the payment.

WooCommerce Apple Pay support for all browsers

Google Pay

SettingWhat it does
Gateway Merchant IDYour Buckaroo Gateway merchant ID, from Plaza under Services → Google Pay.
Google Merchant IDYour own ID from the Google Pay & Wallet Console, in the form BCR2DN4T....
List as payment method in checkoutAlso offer Google Pay in the checkout payment list, alongside the express button. Yes by default.
Button styleBlack or White. Black by default.
Button typePlain, Pay with, Buy with, Checkout with, Order with, Book with or Subscribe with. Pay with by default, so existing stores keep the button they already show.

Get your Google Merchant ID before launch day. Google Pay works in test mode without it, but the plugin won't let you switch to Live until it's filled in, and hides Google Pay from customers in the meantime.

PayPal

SettingWhat it does
Merchant IDYour PayPal merchant ID, from PayPal under Business information. Required in Live mode.
Sandbox merchant IDUsed instead when Transaction mode is Test. Optional.
Seller protectionSends the customer's address to PayPal so PayPal seller protection applies. Yes by default.
Button styleGold, Blue, Silver, White or Black. Gold by default.
Button typePlain, Checkout, Buy now or Pay with. Plain by default.
Rounded button shapeShow the button with fully rounded corners. No by default.

PayPal has no List as payment method in checkout setting. While the method is enabled it always appears in the checkout payment list, and Show the express button on controls only the express button.

The sandbox client IDs are handled by Buckaroo, so the sandbox merchant ID is the only extra value you can add for testing.


Buy Now Pay Later

Klarna, Riverty, Billink and In3 have extra requirements compared with other methods:

  • They need additional customer data, such as date of birth, which the plugin collects in checkout when the method is selected.
  • They perform a risk assessment and may decline an order that would have succeeded with another method. Always offer a fallback.
  • They typically use authorise and capture: the amount is reserved at checkout and captured when you ship. See Order management.
  • Some require separate onboarding with the provider before they can go live.

Riverty

Riverty has its own settings beyond the shared ones:

SettingWhat it does
Riverty Pay or CaptureWhether to send a Pay or an Authorize request.
Riverty customer typeBoth, B2C or B2B. With B2B, the method only appears when the customer enters a company name in checkout.
Min / Max order amount for B2BSeparate amount limits that apply to business orders.

Separate B2B limits are useful because business orders are usually larger. You can set a low ceiling for consumers and a much higher one for companies without splitting the method in two.


Bank Transfer

Bank Transfer is asynchronous. The customer places the order, receives the bank details, and the order stays on hold until the money arrives.

SettingWhat it doesDefault
Number of days till order expireHow long the customer has to pay.14
Send emailWhether Buckaroo emails the payment instructions to the customer.No
Show payment proceduresWhether the instructions appear on the thank-you page after checkout.No

Both display options are off by default, which means a customer choosing Bank Transfer may not see how to pay. Switch at least one of them on if you offer this method.


PayPerEmail and PayLink

PayPerEmail sends the customer a payment link instead of taking them through checkout. The plugin can use it in two places, and they are configured separately.

SettingWhat it doesDefault
Show on Checkout pageOffer PayPerEmail as a checkout payment method.No
Show PayPerEmailShow the PayPerEmail action on the admin order screen.Show
Show PayLinkShow the PayLink action on the admin order screen.Show
Due date (in days)How long the payment link stays valid.
Allowed methodsWhich payment methods the link offers the customer.

The admin actions are the more useful half. Create an order in the WooCommerce admin for a customer who ordered by phone or email, then send them a link to pay it. See Order management.



Did this page help you?