ZenotiHelp

Handle refund failures on the New POS Experience

ZTZenoti Docs Team Updated July 13, 2026 1 min readGuide

Beta: The New POS Experience is currently in beta. For the stable experience, see Process refunds.

When an online payment refund cannot be processed (for example, when the gateway rejects the refund), the new POS displays a clear failure state with the reason and the next steps. This ensures failed refunds are never overlooked and that staff know exactly what action to take.

Audience: Front-desk staff processing refunds.

On this page

Before you begin

  • You have the Refund Invoice permission.

What happens when a refund fails

  1. When you initiate a refund, the system attempts the transaction with the payment processor.
  2. If the refund fails, an error message appears with:
    • The reason for the failure (for example, Gateway declined, Original transaction expired, or Invalid card).
    • Recommended next steps (for example, Retry refund, Issue refund as custom payment, or Contact guest for an alternate refund method).
  3. The original transaction remains intact, and the failed refund attempt is logged in the invoice audit log.
  4. Choose your next action from the error state:
    • Retry the refund.
    • Switch refund method (for example, refund to cash or to a gift card if the original card cannot accept the refund).
    • Cancel and follow up offline.

Tips

  • Successful refund workflows are unchanged β€” this article applies only to the failure path.
  • Failed refund attempts are recorded in invoice logs and refund reports.
  • For repeat failures, contact your payment processor or your Zenoti administrator.

Troubleshooting

  • The original transaction is too old to refund. Switch to a different refund method (cash, gift card, or configured custom payment).
  • Retry continues to fail. The processor may be temporarily unavailable. Wait and retry, or use a different refund method.
  • The guest cannot accept the alternative refund method. Cancel the in-system refund and follow your organization's offline refund procedure.
Was this article helpful?
Your feedback helps us improve our documentation.