Gift Card Payment Dispute Management Settings
Use this article to configure how Zenoti handles gift cards when a payment dispute is raised. The Payment dispute management settings let you automatically freeze a gift card when the payment that bought it is disputed, and automatically unfreeze it when your business wins the dispute.
Note: For what front desk staff see when they try to redeem a frozen gift card, and how to restore one by hand, see Gift Card Payment Dispute Freeze and Unfreeze. For the other gift card settings, see Configure gift card settings.
Audience: Zenoti administrators who manage gift card policies and payment dispute workflows.
On this page
- Before you begin
- Steps
- How the two dispute settings work together
- Tips
- Troubleshooting
- Related articles
Before you begin
- You must have administrator access to the Zenoti Configuration area.
- The two Payment dispute management settings are organization-level settings. They apply to gift cards sold at every center in your organization.
- The two settings are independent β you can turn on Freeze gift card upon payment dispute without Unfreeze gift cards automatically when the business wins a dispute. The automatic unfreeze only acts on gift cards that were frozen because of a payment dispute, so in practice turn on the freeze setting first.
Permission: You need administrator-level access to modify gift card settings under Configuration.
Steps
Both dispute settings are toggles in the Payment dispute management section of Configuration > Gift cards.
Freeze a gift card upon payment dispute
Turn on this setting to automatically freeze a gift card when the payment used to purchase it is disputed.
- Select the Configuration icon in the left navigation.
- Select Gift cards.
- In the Payment dispute management section, turn on the Freeze gift card upon payment dispute toggle.
- Select Save.
When this setting is on, Zenoti freezes a gift card when the sale invoice it was bought on has an open payment dispute. Zenoti applies the freeze through a scheduled background process, so there can be a short delay between the dispute being recorded and the card being frozen. A frozen gift card cannot be redeemed at the Point of Sale until it is unfrozen β automatically (if you also turn on the next setting) or manually by staff from the guest's profile.
Turning this setting off stops new freezes. It does not unfreeze gift cards that are already frozen.
Unfreeze gift cards automatically when the business wins a dispute
Turn on this setting to automatically restore a frozen gift card when the dispute is resolved in your business's favor.
Important: This setting only acts on gift cards that were frozen because of a payment dispute. If Freeze gift card upon payment dispute has never been on, no cards will have been frozen and this setting has nothing to act on.
- Select the Configuration icon in the left navigation.
- Select Gift cards.
- In the Payment dispute management section, confirm that Freeze gift card upon payment dispute is turned on.
- Turn on the Unfreeze gift cards automatically when the business wins a dispute toggle.
- Select Save.
When this setting is on and a dispute is won, Zenoti automatically unfreezes the gift card, provided no other dispute against the same card is still open. Zenoti also extends the card's expiry date by the number of days it was frozen, so the guest does not lose validity while the dispute was open.
How the two dispute settings work together
| What happens | Freeze gift card upon payment dispute | Unfreeze gift cards automatically when the business wins a dispute | Result |
|---|---|---|---|
| A dispute is opened | On | On or off | The gift card is frozen and cannot be redeemed. |
| A dispute is opened | Off | On or off | The gift card is not frozen. |
| The dispute is won | On | On | The gift card is unfrozen automatically and its expiry date is extended by the days it was frozen. |
| The dispute is won | On | Off | The gift card stays frozen until staff restore it manually from the guest's profile. |
| The dispute is lost | On | On or off | The gift card stays blocked permanently. Neither setting nor a manual restore can unblock it. |
Worked example
Your organization turns on both Freeze gift card upon payment dispute and Unfreeze gift cards automatically when the business wins a dispute.
- A guest buys a $150 gift card that expires on December 31. On March 1, the guest's bank opens a dispute on the purchase.
- Zenoti freezes the card. When the gift card is presented at checkout, the front desk sees that it cannot be used because its payment is under dispute.
- On March 21, your business wins the dispute. Zenoti unfreezes the card automatically and moves its expiry date 20 days later, to January 20. The full $150 balance is available again.
- If the dispute had been lost instead, the card would have stayed blocked permanently.
Tips
- Turn on both dispute settings for a fully automated workflow. With only the freeze setting on, your team must restore every frozen card by hand after a won dispute.
- Choose freeze without automatic unfreeze if you want a review step. Cards then stay frozen after a won dispute until a staff member restores them from the guest's profile, which lets you check each case before the guest can redeem.
- Other freezes are not affected. The automatic unfreeze applies only to gift cards frozen because of a payment dispute. Gift cards frozen any other way follow their own unfreeze process.
- Train your front desk team. A guest whose gift card is frozen cannot redeem it at checkout. Make sure staff can recognize the dispute messages and explain the expected resolution timeline.
- Review dispute outcomes promptly. The automatic unfreeze depends on the won outcome reaching Zenoti from your payment processor. If a card stays frozen after a win, check the outcome recorded in your payment processor.
Troubleshooting
| Problem | Likely cause | Resolution |
|---|---|---|
| A gift card was not frozen when a payment dispute was raised. | Freeze gift card upon payment dispute is off, the dispute has not yet reached Zenoti, or the scheduled freeze has not run yet. | Turn on the setting under Configuration > Gift cards > Payment dispute management and select Save. If it is already on, allow time for the scheduled process, then confirm that the dispute is recorded against the invoice the gift card was sold on. Contact Zenoti Support if the issue persists. |
| A gift card was not unfrozen after your business won the dispute. | Unfreeze gift cards automatically when the business wins a dispute is off, the won outcome did not reach Zenoti, or another dispute on the same card is still open. | Turn on the setting if it is off. If it is on, confirm the outcome in your payment processor and check for any other open dispute on the card. To release the card now, restore it manually from the guest's profile. |
| Changes to the toggles do not appear to take effect. | The change was not saved. | Return to Configuration > Gift cards > Payment dispute management, verify the toggle states, and select Save. |
| A guest cannot redeem a gift card and no dispute was raised. | The card is blocked for another reason, such as expiry or a different freeze. | Open the guest's profile, select the Gift Cards tab, and check the card's status. A dispute freeze shows as Disputed or Dispute: Lost; anything else has a different cause. |