ZenotiHelp

Gift Card Liability Report — CC Liability Breakdown and Bonus Gift Card Refund Correction

ZTZenoti Docs Team Updated September 5, 2026 6 min readReference

The Gift Card Liability report includes two specialized computation modes that support internal liability reconciliation: a credit card liability breakdown that isolates gift card liability attributable to credit card purchases, and a bonus gift card refund correction that adjusts value-based liability figures when a bonus card's parent sale has been refunded. This article explains how to interpret the outputs of both modes and what each column represents.

Audience: Finance administrators and reporting staff who reconcile gift card liability figures across centers.


On this page


Before you begin

  • You must have access to the gift card reports section in Zenoti.

  • The CC liability breakdown mode is intended for internal callers such as the daily liability snapshot. When this mode is active, the report does not return record counts, totals result sets, or row-limit filtering.

  • The bonus gift card refund correction applies only when the report is run in value-based liability mode. If your organization uses quantity-based liability, the correction does not apply.

  • You need the following permissions:

    Permission: Edit under GiftCards in the Loyalty Manager section — Required to modify existing gift card templates.

    Permission: Edit under GiftCardType in the Administrator section — Required to modify existing gift card occasions.

Steps

Open the Gift Card Liability report

  1. Navigate to Reports.
  2. Search for and open the Gift Cards Liability report.
  3. Set your date range using the Dates filter.
  4. Select the centers you want to include in the report using the Centers filter.
  5. Set the Liability Type, then select Refresh to generate the report.

Interpret CC liability breakdown output

When the CC liability breakdown mode is active, the report returns a per-center breakdown filtered to gift cards whose original sale payment date falls within the last 180 days relative to the report end date. Each row in the output represents one center's liability position for credit card–purchased gift cards only — this window represents the credit card chargeback exposure period.

The report computes CCWindow Opening Balance, CCWindow Sales, CCWindow Redemptions, CCWindow Refunds, CCWindow Suspense, CCWindow Expired, and CCWindow Closing Balance columns using only credit card–attributed transactions within this 180-day window. See Column descriptions for definitions of each column.

Note: When CC liability mode is active, the report skips the record count and totals result sets. Row-limit filtering is also ignored. This behavior is by design for internal daily snapshot callers.

Interpret bonus gift card refund correction output

When the report runs in value-based liability mode, it applies a correction for bonus gift cards whose parent sale invoice has been refunded.

  1. The report detects whether a bonus gift card's originating sale invoice has a corresponding refund record.
  2. If the parent sale was refunded before the report's start date, the bonus card's value is deducted from both the Opening Balance and the Closing Balance.
  3. If the parent sale was refunded within the report period (between the start date and end date), the bonus card's value is added to Refunds and deducted from the Closing Balance.
  4. A guard prevents double-counting: if a parent sale was already refunded before the period start, the card is excluded from the within-period refund adjustment.

Important: The bonus gift card refund correction applies only in value-based liability mode. If you are reviewing quantity-based liability figures, bonus card refunds are not reflected in the output.

Filter criteria

The following filters control the scope of the Gift Card Liability report output.

Filter Description
Start Date The beginning of the reporting period. Refunds recorded before this date affect Opening Balance and Closing Balance figures rather than the Refunds column.
End Date The end of the reporting period. The CC liability window is calculated as the 180 days preceding this date. Refunds recorded on or between the start and end dates affect the Refunds column and Closing Balance.
Center Filters the report to one or more specific centers. In CC liability mode, results are returned as a per-center breakdown.
Liability Type Determines whether the report uses value-based or quantity-based liability. The bonus gift card refund correction applies only when value-based liability is selected.

Column descriptions

CC liability breakdown columns

The following columns appear in the CC liability breakdown output. All figures are filtered to gift cards whose original sale payment date falls within the 180-day chargeback window ending on the report end date.

Column Description
Center The center for which the liability row is calculated.
CCWindow Opening Balance The total outstanding credit card–purchased gift card liability at the start of the report period, scoped to the 180-day CC chargeback window.
CCWindow Sales The value of gift cards sold via credit card during the report period. Attribution uses the row's own payment type for sale records.
CCWindow Redemptions The value redeemed against credit card–purchased gift cards during the report period. Attribution for redemption rows follows the payment type of the original sale, not the redemption transaction itself.
CCWindow Refunds The value refunded on credit card–purchased gift cards during the report period. Attribution uses the row's own payment type for refund records. A gift card refunded via a non–credit card method is excluded from this figure even if the original purchase was made by credit card.
CCWindow Suspense The value of credit card–purchased gift cards held in a suspense state during the report period.
CCWindow Expired The value of credit card–purchased gift cards that expired during the report period.
CCWindow Closing Balance The total outstanding credit card–purchased gift card liability at the end of the report period, scoped to the 180-day CC chargeback window. Calculated as: CCWindow Opening Balance + CCWindow Sales − CCWindow Redemptions − CCWindow Refunds − CCWindow Expired ± CCWindow Suspense adjustments.

Note: Payment type attribution differs by record type. Redemption rows inherit the payment type of the original sale — this is determined once at the sale level and propagated to all rows for the same gift card, with no per-row branching applied. Sale and refund rows use their own payment type. This means a credit card–purchased gift card that is refunded via cash or another non–credit card method will not appear in the CCWindow Refunds figure.

Bonus gift card refund correction behavior

The table below describes how the bonus gift card refund correction affects report columns depending on when the parent sale refund was recorded.

Scenario Effect on Opening Balance Effect on Refunds Effect on Closing Balance
Parent sale refunded before the report start date Reduced by the bonus card's value No change Reduced by the bonus card's value
Parent sale refunded within the report period No change Increased by the bonus card's value Reduced by the bonus card's value
Parent sale refunded before start date AND within period (double-count guard) Reduced by the bonus card's value (pre-period refund only) No additional adjustment Reduced by the bonus card's value (pre-period refund only)

Note: The double-count guard ensures that a bonus card whose parent was already refunded before the period start is not also counted in the within-period Refunds column. Each bonus card is adjusted exactly once.

Tips

  • When reviewing CC liability figures, compare the CCWindow Refunds column against the full liability report to identify gift cards originally purchased by credit card but refunded through a different payment method. These cards reduce total liability but do not appear in the CCWindow Refunds figure.
  • If a bonus gift card appears to inflate your liability figures unexpectedly, check whether the parent sale invoice has been refunded. The bonus gift card refund correction will reduce the liability once the refund is recorded, but only in value-based liability mode.
  • The CC liability breakdown mode is designed for automated internal callers. If you are running the report manually for ad hoc analysis, confirm with your finance team whether the CC breakdown or the standard full-liability output is the appropriate view for your use case.
  • When comparing Opening Balance figures across consecutive report periods, verify that the prior period's Closing Balance matches the current period's Opening Balance. Discrepancies may indicate bonus gift card refund corrections that were applied retroactively to the prior period.
  • To investigate a specific bonus gift card correction, cross-reference the card's sale invoice against refund records. The correction is triggered by the presence of a refund record on the parent sale invoice, not on the bonus card itself.
  • The 180-day CC chargeback window is fixed relative to the report end date and cannot be adjusted. If you need to assess chargeback exposure for a different window, change the report end date accordingly.
Was this article helpful?
Your feedback helps us improve our documentation.