Configuration
The app needs your Buckaroo keys before it can process anything. You set these, and everything else, inside the Buckaroo app for Lightspeed rather than in the Lightspeed back office.
Open the app
- Go to lightspeed.buckaroo.io and log in with the account you registered during installation.
- Click Settings in the left-hand menu.
You can also reach the app from Lightspeed: go to Apps → Purchased apps → Buckaroo Payments and click Go to App.
The left-hand menu holds four sections:
| Section | What it does |
|---|---|
| Settings | Your Buckaroo keys, bank statement descriptions and the extras below. |
| Payment Methods Settings | Switches each method to live, test or off. See Payment methods. |
| Order Payment Methods | Sets the order methods appear in your checkout, per country. See Checkout order. |
| Verification Methods | Switches iDIN on or off. See Payment methods. |
The store you are configuring is shown at the top of the menu, with its Lightspeed domain and shop number. Check this before you change anything if you run more than one store. You can also switch the app's interface language there.
Credentials
Both keys come from Buckaroo Plaza, under Settings → API Keys.
| Setting | What to enter |
|---|---|
| Store Key | The key of the Buckaroo store this Lightspeed store should report to. Each store has its own key, which is what keeps transactions separated per store. |
| Secret Key | The secret key for your Buckaroo account. This is the same key across all of your stores. |
Click Test Connection after saving. This confirms the app can reach your Buckaroo account, so you find a mistyped key here rather than in a failed checkout.
If your Buckaroo account holds several stores, check that you copied the key of the store you actually want to use. Test Connection succeeds with any valid key, including one from the wrong store, so it cannot catch this for you.
Descriptions
These two fields set the text your customer sees on their bank statement. Include something recognisable, such as your store name, so customers do not report the payment as unknown.
| Setting | Used for |
|---|---|
| Debit transaction description | Payments. |
| Credit transaction description | Refunds. Prefixing it with something like Refund makes the two easy to tell apart in your reconciliation. |
Both fields accept these tags, which the app fills in per transaction:
| Tag | Example |
|---|---|
{order_number} | 123123123 |
{shop_name} | buckaroo.shop |
So {order_number} - {shop_name} reaches your customer as 123123123 - buckaroo.shop. The app previews the result under each field.
Extras
None of these are required.
Shop Image
A URL pointing at your store logo. Some payment methods show an intermediate page where the customer fills in extra details, and your logo appears there.
Refunds
Controls whether the app creates refunds in Buckaroo for you. This is disabled by default, so it is worth a decision rather than being left alone.
- Enabled: you issue full or partial refunds from your Lightspeed back office. Creating a credit note triggers the refund, which the app processes in Buckaroo and sends to the customer.
- Disabled: credit notes in Lightspeed do nothing at Buckaroo. You refund from the transaction overview in Plaza instead.
Most merchants enable it, so that refunds and the administration behind them stay in one system. See Order management for what each option means day to day.
Cancel Expired Period
How long an order waits for payment before the app cancels it automatically. Pick from the dropdown, and pick a period that covers the slowest method you offer.
Custom Icons
Shows the icons of your active payment methods at the bottom of your checkout page. Safe to enable, and it keeps itself current as you switch methods on and off.
Show payment method logos in your store footer
This one is set in Lightspeed, not in the Buckaroo app. In your Lightspeed back office, go to Settings → Web extras → Custom Head Code and paste the following into the External script URL field:
https://lightspeed.buckaroo.io/custom-head-code.jsThe app shows this same URL under Extras, so you can copy it straight from there.
Updated about 16 hours ago