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
- Go to WooCommerce → Settings → Buckaroo Settings → Payment Methods.
- Select the settings icon next to the method you want.
- Tick Enable/Disable.
- Set Transaction mode to
TestorLive. - 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.

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.
| Setting | What it does |
|---|---|
| Enable/Disable | Whether the method appears in checkout at all. |
| Transaction mode | Test or Live, set per method. |
| Title | The label shown in checkout. |
| Description | Explanatory text under the method name in checkout. |
| Payment fee | A fixed amount, for example 1.50, or a percentage, for example 1%. Decimals use a dot. |
| Minimum order amount allowed | Hide the method below this cart total. Zero or empty means no limit. |
| Maximum order amount allowed | Hide 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:
- Alipay
- Apple Pay
- Bancontact
- Bank Transfer
- Belfius
- Billink
- Bizum
- BLIK
- Credit and debit cards
- EPS
- Giftcards
- Google Pay
- iDEAL | Wero
- In3
- KBC
- Klarna
- MB Way
- Multibanco
- Pay by Bank
- PayPal
- PayPerEmail
- Przelewy24
- Riverty
- SEPA Direct Debit
- Swish
- Trustly
- TWINT
- WeChat Pay
- Wero
- Zakelijk op rekening (by ABN AMRO)
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:
| Setting | What it does |
|---|---|
| Allowed provider | Which brands the customer can choose. Deselect a brand to hide it. |
| Show separate in checkout | Which 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.

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:
| Section | What's in it |
|---|---|
| No heading | Enable/Disable, the method's credentials, Transaction mode, Payment fee and the Minimum and Maximum order amount allowed. |
| Method specific settings | Where 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 settings | How 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
| Setting | What it does |
|---|---|
| Show the express button on | The 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 style | The colour of the button. The options differ per method, listed below. |
| Button type | The wording shown on the button next to the wallet's own mark, such as "Buy with" or "Checkout". Plain shows the mark alone. |
| Button preview | Shows 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.
| Method | Credential | Test mode | Live mode |
|---|---|---|---|
| Apple Pay | GUID | Required | Required |
| Google Pay | Gateway Merchant ID | Required | Required |
| Google Pay | Google Merchant ID | Not required | Required |
| PayPal | Merchant ID | Not required | Required |
| PayPal | Sandbox merchant ID | Optional | Not 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
| Setting | What it does |
|---|---|
| GUID | Your Buckaroo GUID, from Plaza under My Buckaroo → General. |
| List as payment method in checkout | Also offer Apple Pay in the checkout payment list, alongside the express button. Yes by default. |
| Button style | Black, White or White outline. Black by default. |
| Button type | Plain, 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.

Google Pay
| Setting | What it does |
|---|---|
| Gateway Merchant ID | Your Buckaroo Gateway merchant ID, from Plaza under Services → Google Pay. |
| Google Merchant ID | Your own ID from the Google Pay & Wallet Console, in the form BCR2DN4T.... |
| List as payment method in checkout | Also offer Google Pay in the checkout payment list, alongside the express button. Yes by default. |
| Button style | Black or White. Black by default. |
| Button type | Plain, 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
| Setting | What it does |
|---|---|
| Merchant ID | Your PayPal merchant ID, from PayPal under Business information. Required in Live mode. |
| Sandbox merchant ID | Used instead when Transaction mode is Test. Optional. |
| Seller protection | Sends the customer's address to PayPal so PayPal seller protection applies. Yes by default. |
| Button style | Gold, Blue, Silver, White or Black. Gold by default. |
| Button type | Plain, Checkout, Buy now or Pay with. Plain by default. |
| Rounded button shape | Show 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:
| Setting | What it does |
|---|---|
| Riverty Pay or Capture | Whether to send a Pay or an Authorize request. |
| Riverty customer type | Both, B2C or B2B. With B2B, the method only appears when the customer enters a company name in checkout. |
| Min / Max order amount for B2B | Separate 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.
| Setting | What it does | Default |
|---|---|---|
| Number of days till order expire | How long the customer has to pay. | 14 |
| Send email | Whether Buckaroo emails the payment instructions to the customer. | No |
| Show payment procedures | Whether 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.
| Setting | What it does | Default |
|---|---|---|
| Show on Checkout page | Offer PayPerEmail as a checkout payment method. | No |
| Show PayPerEmail | Show the PayPerEmail action on the admin order screen. | Show |
| Show PayLink | Show the PayLink action on the admin order screen. | Show |
| Due date (in days) | How long the payment link stays valid. | |
| Allowed methods | Which 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.
Updated 18 days ago