Skip to content

What should I do when a payment fails?

A declined payment shows up directly in the checkout tunnel with the reason: retry the same method, or cover the rest with another one.

Updated on July 3, 2026

A declined payment shows up directly in the tunnel's panel, with a clear message and a technical code alongside it. Depending on the case, you're offered three options: retry the same method, pay the rest another way, or cancel.

What you see on screen

The tunnel shows the most readable error message available (the reason returned by the bank or the payment gateway), with a technical code alongside it for tracking purposes. No information is lost: nothing is hidden behind a generic message.

Retry the same method

If the failure was a fluke (a card that didn't read, a connection dropping for a second), the "Retry" button relaunches the same payment leg without starting over and without any risk of double charging.

Pay the rest another way

If there's still an amount due and another payment method is available, a "Pay another way" button lets you pick one or more methods to cover what's missing, for example switching from card to cash. Methods already successfully collected are never offered again, to avoid any double charge.

Cancel the sale

If you'd rather not continue, the cancel option remains available. The cancellation screen then shows exactly what's already been collected and needs to be given back to the client: cash to return, or a card refund to process, based on what was actually paid before the cancellation.

Edge cases

Part of the payment already went through. The amount from successful legs stays acquired. Only the remainder is affected by the failure, never the whole sale.

No other method is available. The "Pay another way" button only appears if there's still an amount due and a method not yet used. Otherwise, only the retry or cancel options are shown.

You don't understand the error code shown. The main message (in plain language) always takes priority over the technical code, which stays displayed for reference only, for any follow-up.

Every attempt, successful or failed, stays tracked in the NF525 fiscal audit trail: nothing is ever silently erased or recalculated, that's what guarantees your register's integrity.

Related articles

Was this article helpful?