Gift Card Dispute Evidence — Document Generator
When a guest disputes a gift card charge through their bank or card issuer, Zenoti can generate a structured evidence document to support your chargeback response. This article explains how to generate that document and what information it contains.
Audience: Front desk staff and administrators who manage gift card payment disputes.
On this page
Before you begin
You must have an active gift card chargeback or payment dispute open for the card you want to document.
The gift card must have been sold through Zenoti. Evidence generation is not available for externally issued cards.
You need the following permission:
Permission: Edit under GiftCards in the Loyalty Manager section — required to access dispute management actions for gift cards.
Steps
Generate the dispute evidence document
- Navigate to Configuration > Gift cards > Gift card settings.
- Locate the gift card associated with the payment dispute. You can search by card number (enter the last two digits of the masked number, or the full card number if you have the Show gift card numbers permission under GiftCards in the Loyalty Manager section).
- Open the gift card's detail view and select the dispute management action for the disputed transaction.
- Select the option to generate the dispute evidence document.
The system generates the document and makes it available for download. If no card details and no redemption history exist for the dispute, the system returns an empty document rather than a partially populated template.
Understand the evidence document contents
The generated evidence document contains two sections: a summary of the gift card and a redemption history table.
Gift card summary
The summary section includes the following fields:
| Field | Description |
|---|---|
| Gift card code | The gift card number, masked to show only the last two digits (format: ****XX). |
| Initial balance | The full face value loaded onto the card at the time of purchase. |
| Current balance | The remaining balance on the card at the time the document is generated. |
| Purchase date | The date the gift card was sold. |
| Expiry date | The date the gift card expires, if applicable. Cards set to never expire show no expiry date. |
| Purchased by | The name of the guest who purchased the gift card. |
| Recipient name | The name of the guest the card was purchased for, if the card was bought for another guest. |
| Recipient email | The email address of the recipient, if provided at the time of purchase. |
Redemption history table
Below the summary, the document includes a table listing every redemption made against the card:
| Column | Description |
|---|---|
| Date | The date of the redemption. |
| Center name | The name of the center where the redemption occurred. |
| Redeemed amount | The value applied from the gift card on that transaction. |
| Invoice | The invoice number associated with the redemption. |
| Redeemed by | The name of the guest or staff member who applied the card. |
A totals row at the bottom of the table shows the sum of all redeemed amounts across all listed redemptions.
Note: If the gift card has never been redeemed, the redemption history table contains no rows. In this case, only the gift card summary is populated.
Tips
- Masked card number in the document — The evidence document always shows the masked card number (
****XX). If your chargeback processor requires the full card number, a staff member with the Show gift card numbers permission under GiftCards in the Loyalty Manager section can retrieve it from the gift card detail screen before generating the document. - Empty document behavior — When neither card details nor redemption history exist for the dispute, the system returns a blank document. This typically means the card number submitted with the dispute does not match any gift card sold through Zenoti. Verify the card number and resubmit.
- Current balance reflects the moment of generation — If a redemption occurs after you generate the document, regenerate it to capture the updated balance before submitting your dispute response.
- Same-center redemptions and fraud alerts — The gift card fraud alert (configured at Configuration > Gift cards > Gift card settings > Gift card alerts) fires when a card is redeemed at a different center from where it was purchased, within a configurable time window, and above a configurable redemption amount threshold. Redemptions at the purchase center do not trigger the alert. The evidence document reflects all redemptions regardless of the alert status.
Troubleshooting
The system returns an empty document
The evidence document is empty when no card details and no redemption history exist for the dispute. Possible causes:
- The card number associated with the dispute does not match a gift card sold through Zenoti. Confirm the card number with the disputing guest or their card issuer, then search again.
- The gift card was issued through an external provider (such as Digital Glue / Blackhawk) rather than Zenoti's native gift card system. Evidence generation applies only to native Zenoti gift cards.
The gift card code appears masked and I need the full number
Only staff with the Show gift card numbers permission under GiftCards in the Loyalty Manager section can view the unmasked card number. Ask an authorized administrator to retrieve the full number from the gift card detail view.
The redemption history is incomplete
The redemption history table includes all redemptions recorded against the card in Zenoti. If a redemption appears to be missing, verify that the invoice for that transaction is closed and associated with the correct gift card. Open or voided invoices may not appear in the history.