Test and go live
Verify your integration in test mode, then work through the checklist before you take real payments.
Testing
Enable test mode
The Buckaroo plugin sets mode per payment method, not globally. For each method you want to test, go to Stores → Configuration → Sales → Buckaroo → Payment methods and set it to Test.
Test transactions use the same Store key and Secret key as live transactions. Nothing else changes, which is exactly why you need to check every method again before launch.
Test data
Buckaroo provides test credentials and simulated outcomes for each payment method. See Test transactions for the full set, including test card numbers and how to trigger specific results.
For most redirect methods, the test payment page lets you choose the outcome directly: success, failure, cancellation or pending.
What to test
Test the paths that break, not just the happy path.
| Scenario | What you're checking |
|---|---|
| Successful payment | Order moves to Processing, invoice created, confirmation email sent |
| Failed payment | Order is cancelled, stock returned, customer sees a usable error |
| Customer cancels at the bank | Order is cancelled, cart is restored if Keep Cart Alive is on |
| Customer closes the browser mid-payment | Push still arrives and updates the order |
| Full refund | Credit memo created, refund visible in Plaza |
| Partial refund | Correct amount refunded, remaining balance still correct |
| Authorise then capture | Reservation at checkout, capture on invoice |
| Cancel an authorised order | Reservation released |
| Guest checkout | Works identically to a logged-in customer |
| Each store view | Correct methods, currency, language and Store key |
| Mobile | Especially for wallet and app-based methods |
The "customer closes the browser mid-payment" test is the important one. It's the only test that proves your push endpoint works independently of the browser redirect, and broken push is the single most common production problem.
Penny tests
Test mode proves the integration works. It doesn't prove your live configuration works, because live keys, your live contract and settlement are all different things.
Once a method is switched to Live, place a real order for the smallest amount you can and pay for it yourself. Do this for every method you're able to use personally, not just one.
For each method, check that:
- the order reaches the right status in the Magento admin. A paid order should show as
Processing, not sit inPending payment - the invoice is created as expected
- the transaction appears in Plaza under your live account, with the same amount and status
- refunding from Magento returns the money
If the status doesn't match what you configured, check your mapping under Order management. An order stuck in Pending payment after a payment you know succeeded points at the push message rather than the mapping.
Then refund it. You get the amount back minus any transaction fee, which is a small price for knowing the full loop works: payment, push, invoice, refund, settlement.
You won't be able to test everything yourself. Buy Now Pay Later methods, or methods tied to a country where you don't hold an account, will have to rely on test mode. Cover what you can.
Go-live checklist
Work through this before your first real payment.
Credentials and connection
- Live Store key and Secret key entered in Magento, for every store view
- Buckaroo's push IPs and ports are allowlisted on your firewall or WAF. See Push messages for the current list
- Store is publicly reachable over HTTPS with a valid certificate
- Plugin routes are excluded from Varnish, your CDN and any full-page cache
- Store is not behind basic authentication
- Optional: push failure emails in Plaza (Settings → Websites → Push settings → E-mail push failure). Useful for the first days after launch, though it also emails on failures that later succeed on retry
Payment methods
- Every method you intend to offer is set to Live, not Test
- No method is left on Test
- Every enabled method is active on your Buckaroo contract
- Method-specific onboarding is complete (Apple Pay domain verification, PayPal onboarding, BNPL provider onboarding)
- Sort order matches how your customers actually pay
- Country and customer-group restrictions are correct per store view
- Titles are translated for every store view
Configuration
- Transaction label is set and recognisable on a bank statement
- Invoice handling matches your fulfilment process
- Refund settings match your operational process
- Order status mapping reviewed if you changed the defaults
- Payment fees, if used, are configured on the right methods and taxed correctly
Store health
- Magento cron is running. Check it, don't assume it
- Plugin is on the latest version
- Store is in production mode
- Debug logging is turned off
- Penny tests done for every method you can pay with yourself: correct order status in Magento, invoice created, and refunded afterwards
After go-live
- Watch the first day of orders for anything stuck in Pending payment
- Confirm settlement appears as expected in Plaza
- Optional: subscribe to Buckaroo status updates for incidents and maintenance
- Optional: subscribe to plugin releases on GitHub. Open the repository, select Watch → Custom, tick Releases and save. New payment methods, scheme changes and security fixes all arrive this way, so it's worth knowing when one lands. See Releases and upgrading
Updated 2 minutes ago