Dispute Evidence — Supporting Document Types
When a gift card payment is disputed by a cardholder, Zenoti assembles a dispute evidence package to support the business in responding to the chargeback. This article explains how the Gift Card Details document type fits within that framework, so front desk staff and administrators know what evidence Zenoti generates on the business's behalf.
Audience: Center administrators and front desk staff who manage gift card chargebacks and payment disputes.
On this page
- Before you begin
- How dispute evidence works
- Gift Card Details document type
- Tips
- Troubleshooting
- Related articles
Before you begin
- Your organization must have gift card sales enabled. Go to Configuration > Business details > Business setup > Features and confirm that Enable sale of gift cards on POS is on.
- You must have the Edit permission under GiftCards in the Loyalty Manager section of your security role to view and act on dispute-related gift card records.
- Payment dispute management settings are available at Configuration > Gift cards > Gift card settings > Payment dispute management.
How dispute evidence works
When a guest's payment processor raises a chargeback against a gift card purchase, Zenoti generates a structured evidence package. This package is assembled from one or more named document types, each built from a dedicated document generator and a corresponding template.
The dispute evidence framework supports multiple document types. Each type is assigned a unique identifier that the system uses to route the evidence request to the correct generator. The framework is designed so that gift card chargebacks are handled by a dedicated generator — separate from other evidence types your organization may use.
Gift Card Details document type
The Gift Card Details document type is the named document that Zenoti uses when assembling chargeback evidence for gift card payments. It is one member of the broader dispute evidence framework and is generated by a dedicated generator mapped specifically to gift card transactions.
When a dispute is raised against a gift card sale, the evidence package that Zenoti generates uses this document type to capture the relevant gift card information. This ensures that the evidence submitted is specific to the gift card transaction in question, rather than relying on a generic evidence template.
What the document includes
The Gift Card Details document draws on the transaction record of the gift card sale. The information captured supports the business's position in a chargeback response by confirming that a valid gift card was sold and delivered.
When this document type is used
Zenoti uses the Gift Card Details document type automatically when a payment dispute is identified against a gift card invoice. You do not need to select the document type manually — the system routes the evidence request to the correct generator based on the transaction type.
Note: For gift cards that have been frozen due to an active payment dispute, the card cannot be redeemed until the dispute is resolved. If your organization wins the dispute, you can configure Zenoti to unfreeze the card automatically. See Configuration > Gift cards > Gift card settings > Payment dispute management and the setting Unfreeze gift cards automatically when the business wins a dispute.
Worked example
A guest purchases a $100 amount-based gift card at your center. Three weeks later, the guest's card issuer initiates a chargeback. Zenoti identifies the transaction as a gift card sale and routes the evidence request to the Gift Card Details generator. The resulting document is included in the dispute evidence package submitted to the payment processor, showing that a valid gift card was sold for $100 and was associated with the guest's transaction record.
Tips
- Verify that Freeze gift card upon payment dispute is enabled under Configuration > Gift cards > Gift card settings > Payment dispute management so that disputed cards are automatically locked and cannot be redeemed while the dispute is open.
- If your organization wins a dispute and a card was frozen, you can enable Unfreeze gift cards automatically when the business wins a dispute to restore the card balance without manual intervention.
- Review the gift card transaction in the guest's profile under the Gift Cards tab to confirm the card details match the dispute record before the evidence package is submitted.
Troubleshooting
The gift card is still active after a dispute was raised. Verify that Freeze gift card upon payment dispute is enabled at Configuration > Gift cards > Gift card settings > Payment dispute management. If the setting is off, the card is not frozen automatically and will remain redeemable. Enable the setting and freeze the card manually from the guest's profile if needed.
The gift card was not unfrozen after the business won the dispute. Check whether Unfreeze gift cards automatically when the business wins a dispute is enabled at Configuration > Gift cards > Gift card settings > Payment dispute management. If this setting is off, you must unfreeze the card manually from the guest profile after confirming the dispute outcome.
Front desk staff cannot view gift card dispute details. This action requires the Edit permission under GiftCards in the Loyalty Manager section of the security role. Contact your administrator to review and update the security role assignment.