ZenotiHelp

Monitor the Disputes management dashboard

ZTZenoti Docs Team Updated October 23, 2026 8 min readGuide

The Disputes management dashboard is where you monitor every payment dispute (chargeback) across your organization in one place β€” summary outcomes, a filterable dispute list, and export tools. This article explains how to read the dashboard, filter it by center and status, switch between manually handled and AI-assisted disputes, export the list, and manage who receives dispute notifications. It is part of AI Dispute Manager (AIDM), the AI-assisted chargeback-defense add-on inside Zenoti Payments.

Audience: Finance managers and back-office staff who monitor payment disputes and reconcile outcomes.

On this page

Before you begin

  • The dashboard reads dispute records that already exist in Zenoti Payments. For how base disputes, statuses, and dispute fees work, see Defend payment disputes in the Payments category.

Availability: AI Dispute Manager is a paid add-on activated through the Zenoti Marketplace. See Activate AI Dispute Manager.

  • You need the following permission:

Permission: Dispute Payments (on the Payments security object) β€” Required to open the Disputes management dashboard, view the dispute list, configure per-center AI, and export. A single permission governs the whole feature.

Steps

Open the dashboard

  1. Open the Disputes management dashboard for your organization within Zenoti Payments.
  2. Review the Disputes Summary at the top of the page. The metrics reflect the selected period (by default, the last 365 days) and the current center filter.

Disputes Summary metrics

The Disputes Summary shows the following metrics:

Metric What it shows
Total Total number of disputes in the selected period. The sub-label names the period, such as Last 365 days.
Won Disputes won, with the win rate.
Lost Disputes lost, with the loss rate.
Pending Disputes awaiting a processor decision, with the count awaiting decision.
New New disputes that need action, with the count still to action.
Amt Disputed Total amount disputed, with the number of disputes.
Recovered Total recovered amount, with the number won.
Amt Lost Total amount lost, with the number lost.
Fees Paid Total dispute fees paid across the period. This metric appears depending on your organization's billing arrangement, so it may not show for every organization.

Note: Processor dispute fees apply to a dispute regardless of which mode handled it. The AI mode does not waive or change the fee. For how dispute fees are charged, see Defend payment disputes.

Filter by center

  1. Open the center filter. It defaults to all centers.
  2. Search for a center by name, then select it to scope the dashboard to that center.
  3. Look for the AI-enabled indicator next to a center's name β€” this marks centers where AI dispute defense is active. Use it to confirm which centers are running AIDM.

The Disputes Summary metrics and the dispute list both update to match the selected center.

Switch between the All, Manual, and AI-Assisted tabs

Use the view tabs above the dispute list to compare how disputes were handled:

  • All β€” Every dispute in the current filter.
  • Manual β€” Disputes handled without AI. These are Standard-mode disputes that a user assembled and submitted.
  • AI-Assisted β€” Disputes where AI generated the evidence package or submitted the response. Note that once AI prepares a package, the dispute is recorded as AI-assisted even if a user edits it afterward. Auto-defended disputes and buy-now-pay-later disputes (Klarna, Affirm, Afterpay) do not count as AI-assisted and are not included in this tab.

Switching to the AI-Assisted tab and back to Manual lets you compare AI-handled outcomes against manually handled ones over the same period. For how the three defense modes differ, see Defend a dispute.

Filter the dispute list by status tab

The dispute list provides five status-filter tabs that narrow the displayed rows to a specific status group. Select a tab to apply it:

Tab Disputes shown
All All disputes regardless of status.
Needs Response Disputes that require a response before the Respond by deadline.
Under Review Disputes that have been submitted and are awaiting a processor decision.
Won Disputes decided in your favor.
Lost Disputes decided against you.

Note: For the full set of individual dispute statuses (including Partially Won, Auto Defended, Accepted, Withdrawn, and others) and what each one means, see Defend payment disputes in the Payments category. The status-filter tabs group related statuses together for quick scanning; use More Filters to filter by individual statuses.

Use Quick Views to jump to common filter presets

The Quick Views selector applies a preset combination of status and date filters with a single selection, so you do not need to set them manually. The following quick views are available:

Quick View What it applies
All Disputes Clears status and date filters β€” shows every dispute.
Needs Response (7 days) Filters to disputes that need a response within the next 7 days.
Defense Due Today Filters to disputes whose Respond by deadline falls on today's date.
Won (Last 30 days) Filters to disputes won in the last 30 days.

Select a quick view to apply its filters immediately. You can then refine further using More Filters or the status-filter tabs.

Narrow the list with More Filters

  1. Select More Filters to open the advanced filter panel.
  2. Under dispute status, select one or more of the following statuses:
    • Needs Response
    • Warning Needs Response
    • Under Review
    • Won
    • Lost
    • Partially Won
    • Auto Defended
    • Accepted
    • Withdrawn
    • Not Responded
    • Responded
  3. Select a Dispute Type to narrow the list to disputes of a specific type.
  4. Set a date range to limit the list to disputes within specific dates.
  5. Set a minimum and maximum dispute amount to limit the list by value.
  6. Select Apply to run the filters, or Clear all to reset every filter.

Note: For what each dispute status means, see Defend payment disputes in the Payments category. The AIDM dashboard uses the same statuses rather than redefining them.

Sort and open disputes

The dispute list supports pagination and shows the total record count so you know how many disputes match the current filter.

Select any column header to sort the list. The list includes the following columns:

Column What it shows
Status The current dispute status.
AI-assisted Whether AI handled the dispute β€” shown as Yes or β€”.
Respond by The response deadline. This is set by the card network and varies per dispute.
Guest The guest's name, linking to the guest profile.
Invoice The invoice number, linking to the invoice.
Disputed amount The amount the guest disputed.
Dispute type The type of dispute.
Dispute fees The processor fee charged for the dispute.
Center The center where the disputed transaction occurred.

Select a row to open the dispute detail page, where you can preview the evidence documents and review the Dispute, Invoice, and Guest tabs. See Defend a dispute.

Worked example: A finance manager at Downtown Wellness wants to reconcile last quarter's outcomes. They select Downtown Wellness in the center filter, switch to the AI-Assisted tab, open More Filters, select the Won and Lost statuses, set the date range to the last 90 days, set the minimum amount to $100, and select Apply. The list returns 12 disputes totaling $3,240 disputed and $2,100 recovered. They sort by Respond by, open one dispute to confirm its outcome, then export the list as CSV for reconciliation against payment reports.

Export the dispute list

You can export the dispute list from two places on the dashboard:

  • From the dashboard actions menu β€” Choose to export the current filtered list as an Excel file or as a CSV file.
  • From the dispute list More Actions dropdown β€” Select Export to CSV to download the filtered list as a CSV file.

Both exports reflect the active center filter, view tab, status-filter tab, and any applied advanced filters, so narrow the list first to export only the records you need.

After exporting, reconcile the list against your payment reports β€” for example, the Digital Payments Report. See Track fund transfers in the Payments category.

Manage dispute notification recipients

When a dispute is raised, Zenoti sends an email notification to the configured recipients so the dispute can be actioned before its Respond by deadline.

You can manage recipients from two places:

  • From the dashboard actions menu β€” Choose the option to manage dispute notification recipients.
  • From the dispute list More Actions dropdown β€” Select Manage CC Recipients.

In either case:

  1. Add or remove the email recipients who should be alerted when a new dispute is raised.

Note: Organization-level enablement of the dispute notification template and recipient management through the Distribution Management System are documented in the Payments category. See Defend payment disputes.

Tips

  • Set the center filter before you read the Disputes Summary β€” the metrics recalculate to match the selected center, so scope first, then interpret the numbers.
  • Use Quick Views for the most common monitoring tasks: select Defense Due Today at the start of each day to immediately see any disputes that must be actioned today, and Needs Response (7 days) at the start of each week to plan your response workload.
  • Compare the AI-Assisted and Manual tabs over the same period to see how AI-handled outcomes stack up against manually handled ones.
  • Add your finance managers as dispute notification recipients (via Manage CC Recipients in the More Actions dropdown or the dashboard actions menu) so new disputes are seen and actioned well before the Respond by deadline.
  • Export the filtered list at month-end or quarter-end to reconcile recovered and lost amounts against your payment reports.
  • Use the AI-enabled indicator in the center filter to confirm at a glance which centers are running AIDM before you draw conclusions from the tabs.

Troubleshooting

  • The dashboard shows no disputes. Check the center filter and the date range in More Filters. The default period is the last 365 days, so disputes outside that window will not appear. Select Clear all in More Filters to reset the view.
  • A center is missing from the filter, or is not marked AI-enabled. AIDM may not be activated for that center. See Activate AI Dispute Manager, and note that deactivation is not self-service β€” contact your Customer Success Manager.
  • The AI-assisted column shows "β€”" for a dispute you expected AI to handle. That center may be running Standard mode, or the AI evidence package had not yet been built when the dispute was recorded. Check the center's AI configuration in Manage centers and AI modes.
  • You cannot open the dashboard or export. Confirm you have the Dispute Payments permission β€” a single permission governs the dashboard, configuration, and export.
  • An export does not produce a file. Confirm your browser is not blocking the download, then try the alternate format (Excel if you used CSV, or CSV if you used Excel). Both options are available from the dashboard actions menu; Export to CSV is also available from the dispute list More Actions dropdown.
Was this article helpful?
Your feedback helps us improve our documentation.