Configuration
The module's configuration panel sits behind Configure in the Module Manager, and is divided into four sections: Settings, Payment methods, Verification methods and Payment method order. This page covers Settings. The others have their own pages.
Most of what follows is behind Advanced Settings, which is collapsed by default. Open it to reach transaction descriptions, refunds and payment fees.
Mode and credentials
Covered separately, since it is the first thing to set up. See Connect your account.
Transaction description
The description travels with the transaction to Buckaroo and appears on your customer's bank statement, so make it something they will recognise. Your shop name is usually the right choice.
You can mix plain text with two tags:
| Tag | Becomes |
|---|---|
{order_number} | The PrestaShop order number |
{shop_name} | Your shop name |
The panel shows a live example beneath the field as you type, using a sample order number, so you can see what a customer would see. Buttons beside the field insert either tag at the cursor.
Refund settings
Five toggles decide what happens in PrestaShop when you refund an order. Only the first decides whether money actually moves.
| Setting | Default | What it does |
|---|---|---|
| Automatic refunds via Buckaroo | Off | Sends the refund to Buckaroo when you start one in PrestaShop. Without this, a PrestaShop refund is bookkeeping only. |
| Re-stock products | Off | Returns refunded products to inventory. |
| Generate a credit slip | On | Creates a credit note for the refund. |
| Generate a voucher | Off | Creates a voucher for the customer to the value of the refund. |
| Create negative payments on refund | Off | Records a matching negative payment against the order. |
Automatic refunds via Buckaroo is off by default.
Until you switch it on, refunding an order in PrestaShop updates your administration and sends no money back to the customer. See Order management.
There is also a Refund description, which works like the transaction description and appears on the customer's statement for the refund.
Payment fees
You set the fee itself per method, on the method's own configuration. Two settings here apply across all of them.
Fee percentage mode decides what a percentage fee is calculated over, and applies only to percentage fees:
- Subtotal
- Subtotal including tax
Payment fee frontend label is the name shown beside the fee at checkout and on the order, invoice and credit note, including the PDFs. Without it the fee appears without a name, which customers query.
For how to set a fee on a method, see Payment methods.
Debug log
The module writes to its own log file, which you can read from the module's log screen in the back office. This is the first place to look when a payment behaves oddly. See Troubleshooting.
Updated about 12 hours ago