ZenotiHelp

Gift Card Payment Dispute Freeze and Unfreeze

ZTZenoti Docs Team Updated October 13, 2026 6 min readGuide

When a guest disputes the payment used to purchase a gift card, Zenoti can automatically block the card from being redeemed until the dispute is resolved. This article explains what front desk staff see when they try to redeem a disputed gift card, what happens when the dispute is won or lost, and how to restore a frozen card manually.

Audience: Front desk staff and center managers who handle gift card redemption, and administrators who manage dispute outcomes.


On this page


Before you begin

  • Dispute freezes happen only if your organization has turned on Freeze gift card upon payment dispute. See Gift Card Payment Dispute Management Settings.
  • Your payment processor must report dispute events to Zenoti for the freeze to trigger. If you are unsure whether dispute events are flowing to your account, contact your Zenoti account team.

Permission: To restore a disputed gift card, your security role must allow editing gift cards (the GiftCards row in the Loyalty Manager section). Admin path: Configuration > Security > Security Roles > [your role] > Loyalty Manager > GiftCards

The settings that control dispute freezes

Two organization-level settings in the Payment dispute management section of Configuration > Gift cards control this behavior. For the steps to turn them on, see Gift Card Payment Dispute Management Settings.

Setting What it does
Freeze gift card upon payment dispute When the payment used to purchase a gift card enters a dispute, Zenoti blocks the card from being redeemed. Turning this setting off does not unfreeze cards that are already frozen.
Unfreeze gift cards automatically when the business wins a dispute When a won dispute outcome is recorded, Zenoti returns the frozen card to a redeemable state with no staff action.

The two settings are independent. You may turn on Freeze gift card upon payment dispute without Unfreeze gift cards automatically when the business wins a dispute. In that configuration, frozen cards stay blocked after a won dispute until a staff member restores them manually.

How frozen gift cards behave at redemption

The table below summarizes what front desk staff see when they try to redeem a gift card affected by a dispute at the Point of Sale.

Dispute state Freeze gift card upon payment dispute Redemption behavior
Dispute opened On Card blocked. Message: This gift card cannot be used because its payment is under dispute.
Dispute opened Off Card not affected; redemption proceeds normally.
Dispute won On + Unfreeze gift cards automatically when the business wins a dispute on Card restored automatically; redemption proceeds normally.
Dispute won On + Unfreeze gift cards automatically when the business wins a dispute off Card remains blocked until a staff member restores it manually.
Dispute lost On (regardless of the unfreeze setting) Card remains permanently blocked. Message: This gift card cannot be used because its payment dispute was lost.

Important: When a dispute is lost, the gift card is permanently blocked. It cannot be restored through configuration or from the guest's profile. A guest with a permanently blocked card always sees the lost-dispute message at redemption.

When a card is restored after a dispute — automatically or manually — Zenoti extends its expiry date by the number of days it was frozen.

Worked example

A guest purchases a $100 gift card. Two weeks later, they dispute the charge with their bank.

  • Freeze gift card upon payment dispute is on. Zenoti blocks the card. When the guest's partner tries to redeem it at the center, the front desk sees: This gift card cannot be used because its payment is under dispute.
  • Your business submits evidence and wins the dispute.
  • Unfreeze gift cards automatically when the business wins a dispute is on. Zenoti restores the card without any staff action. The guest can now redeem the full $100 balance.
  • If instead the dispute had been lost, the card would remain blocked permanently and the front desk would see: This gift card cannot be used because its payment dispute was lost.

Restore a disputed gift card manually

Use this when a card is still frozen for a dispute — for example, because your organization does not use automatic unfreeze, or because you have decided to release the card before the dispute is closed.

  1. Open the guest's profile and select the Gift Cards tab.
  2. Find the gift card. Its GC status column shows Disputed.
  3. In the Restore column, select Restore.
  4. When asked Are you sure you want to restore this disputed gift card?, confirm.
  5. If your organization masks gift card numbers, enter the gift card code when prompted to validate it.

The card returns to active and can be redeemed again. The Restore link is not shown for a card whose status is Dispute: Lost, because a lost-dispute block cannot be removed.

Tips

  • Dispute-frozen state is separate from other redemption errors. A card frozen for a payment dispute is a distinct condition from an expired card, a one-time-use card already redeemed, or a center-restricted card. When a guest reports they cannot use their gift card, read the redemption message carefully, or check the GC status column on the guest's Gift Cards tab, before taking action.
  • Use both settings together for the smoothest guest experience. Freeze gift card upon payment dispute protects your business while the dispute is open, and Unfreeze gift cards automatically when the business wins a dispute means guests regain access to their card without calling your center.
  • Lost-dispute cards cannot be unblocked in Zenoti. If a dispute is lost and a guest believes this is in error, the resolution must be handled through your payment processor.
  • Choosing freeze without automatic unfreeze. If your organization prefers to review each won dispute before restoring a card, leave Unfreeze gift cards automatically when the business wins a dispute off and restore cards from the guest's profile after review.

Troubleshooting

A gift card was not automatically frozen when a dispute was opened.

Check that Freeze gift card upon payment dispute is turned on under Configuration > Gift cards > Payment dispute management. The freeze is applied by a scheduled background process, so allow a short delay. If the setting is on and the card is still not frozen, confirm with your Zenoti account team that dispute events from your payment processor are being delivered to your organization.

A gift card was not automatically unfrozen after your business won a dispute.

Verify that Unfreeze gift cards automatically when the business wins a dispute is turned on under Configuration > Gift cards > Payment dispute management. Confirm that the outcome recorded in your payment processor is a won outcome — not pending — and that no other dispute against the same card is still open. To release the card now, restore it manually from the guest's Gift Cards tab. If the card still remains frozen, contact Zenoti Support.

The Restore link does not appear for a disputed gift card.

The link appears only for cards whose GC status is Disputed, and only for staff whose security role allows editing gift cards. Cards with Dispute: Lost cannot be restored. If the status is Disputed and you still cannot see the link, ask an administrator to check your security role.

Front desk staff see the lost-dispute message, but your business believes it won the dispute.

The message This gift card cannot be used because its payment dispute was lost reflects the dispute outcome recorded in Zenoti. If this does not match the outcome from your payment processor, contact Zenoti Support to reconcile the dispute status. The block cannot be removed through gift card settings or the guest's profile.

Was this article helpful?
Your feedback helps us improve our documentation.