Order management
What happens to an order after the customer pays, and how to refund, capture or cancel it from the Magento admin.
Order statuses
The plugin maps Buckaroo transaction results onto Magento order statuses. You can change this mapping under Stores → Configuration → Sales → Buckaroo → Advanced, but the defaults suit most shops.
| Setting | Default status | When it applies |
|---|---|---|
| New Status | pending | Order created, payment not yet attempted. |
| Pending Payment Status | pending_payment | Awaiting the customer or the provider. Common with Bank Transfer. |
| Payment Success Status | processing | Payment confirmed. Invoice created according to your invoice-handling setting. |
| Payment Failed Status | canceled | The payment was rejected or abandoned. |
Two related settings sit alongside them: 'Canceled' State on Failed Payment (on by default) and Cancel Order on Browser Back Button (off by default).
An order stuck in Pending payment long after the customer says they paid almost always means the push message didn't arrive. See Troubleshooting.
Pending payments that settle later
Not every method confirms instantly. Bank Transfer can take days. Some BNPL methods hold an order for review. These orders sit in pending until Buckaroo sends a push with the final result, which is why your push endpoint needs to keep working long after the customer has gone.
Invoices
When Magento creates the invoice depends on your Invoice handling setting:
- On successful payment: the invoice is created automatically when the payment succeeds.
- On shipment: you create the invoice yourself, or it's created when you ship.
For methods that use authorise-and-capture, creating the invoice is what triggers the capture. Until you invoice, the money is reserved but not taken.
Refunds
Refund from Sales → Orders → [order] → Credit Memo.
- Open the invoice, or the order if you're refunding offline.
- Select Credit Memo.
- Adjust the quantities or amounts to refund part of the order.
- Select Refund to send the refund to Buckaroo.
The refund is sent to Buckaroo and processed against the original transaction. How long the customer waits depends on the method. Card refunds typically take several working days; bank-based methods are usually faster.
Refund sends the refund to Buckaroo. Refund Offline only creates the credit memo in Magento and does not move any money. If you use Refund Offline by mistake, your books will show a refund that never reached the customer.
Refunds started in Buckaroo Plaza
Refund from Magento wherever you can. It keeps Magento as the single source of truth and returns stock automatically.
If you do need to refund in Plaza, record it in Magento afterwards with an offline credit memo. That keeps your administration and stock correct without sending a second refund to Buckaroo.
Never refund the same order in both systems. Doing so can refund the customer twice, or leave a duplicate credit memo against the order.
The settings behind this are covered in Configuration.
Partial refunds
Most methods support partial refunds. Create a credit memo for the specific items or a custom amount. You can issue multiple partial refunds up to the original transaction total.
Authorise and capture
Some methods support deferred sales. The amount is authorised (reserved on the customer's card or account) at checkout and captured (actually taken) later. Whether a given method supports this depends on the method and on your Buckaroo contract, so check the method's own documentation or the settings for that method in the Magento admin.
| Action | How | Effect |
|---|---|---|
| Authorise | Automatic at checkout when the method is configured for it | Funds reserved, not taken |
| Capture | Create an invoice in Magento | Funds taken |
| Partial capture | Invoice part of the order | Only the invoiced amount is taken |
| Cancel authorisation | Cancel the order before invoicing | Reservation released |
Capturing on time is your responsibility. Authorisations expire, and the window varies by method. If you don't capture before expiry the reservation lapses, the money is never collected, and you'll have to ask the customer to pay again. Capture as soon as you're able to ship.
Cancel an order
Cancelling an unpaid or authorised order in Magento releases the authorisation at Buckaroo. Orders that have already been captured must be refunded instead.
Recovering abandoned payments
Not every order that fails is lost. Second Chance emails customers who started a payment but didn't finish, with a link to complete the order. It's built into the plugin.
Enable it under Stores → Configuration → Sales → Buckaroo → Second Chance. See Built-in features.
Transactions in Buckaroo Plaza
Magento shows you the order. Plaza shows you the payment, including the full status history, the raw push messages, and any provider-side detail such as a card decline code. When you're diagnosing a specific failed payment, Plaza is usually where the answer is.
The full history for a payment is under Transactions in Plaza.
Updated 5 minutes ago