Configuration

Configure how the app behaves: your credentials, the descriptions your customers see on their bank statement, and the customer data your Buy Now Pay Later methods need.

All provider settings live on the Buckaroo Official record under Invoicing → Configuration → Payment Providers. Settings that belong to an individual payment method are covered on Payment methods.

📘

If you haven't added your API keys yet, start with Connect your Buckaroo account.

General settings

SettingWhat it does
Store KeyYour Store key from Buckaroo Plaza. There is one per store in your Buckaroo account.
Secret KeyYour Secret key from Buckaroo Plaza. There is one per account, and it also verifies incoming push messages.
Transaction DescriptionThe description your customer sees on their bank statement.
Refund DescriptionStatement description for refunds. Falls back to the transaction description when left empty.

Transaction description

Set a description your customers will recognise on their bank statement. Unrecognised descriptions are a common cause of chargebacks, so use something that clearly identifies your shop.

You can use these tags:

{order_number}   →  S00042
{shop_name}      →  Storename

Leave the field empty to send the transaction reference on its own. Adding your shop name is usually worth it: {shop_name} {order_number} renders as Storename S00042, which a customer is far more likely to recognise on a statement than an order reference alone.

📘

Refund Description takes the same tags. It falls back to the transaction description, but you may want to make refunds visibly distinct on a statement.

Test mode

The app sets mode on the provider rather than per payment method. See Connect your Buckaroo account.


Customer data for Buy Now Pay Later

Klarna, Billink, In3 and Riverty need extra customer details. The app adds fields for these to the contact form, under Sales & Purchase:

FieldUsed by
Klarna GenderKlarna
Billink BirthdateBillink
Riverty BirthdateRiverty
Riverty SalutationRiverty, for orders in the Netherlands and Belgium

Customers are asked for these in checkout when they're missing, and the answer is saved to the contact so it's prefilled next time. You can also fill them in yourself on the contact record, which is useful for orders you enter on a customer's behalf.

📘

Filling these in on your existing contacts is worth doing before you enable a Buy Now Pay Later method. A customer who has ordered from you before will otherwise be asked for a date of birth at the checkout step, which is where people abandon.


Did this page help you?