ZenotiHelp

Defend a dispute

ZTZenoti Docs Team Updated October 23, 2026 9 min readGuide

AI Dispute Manager (AIDM) helps you respond to payment chargebacks by assembling an evidence package for each dispute. This article explains how to open a dispute, review its evidence document and details, add your own supporting documents, and understand how the package is submitted in each of the three modes.

Audience: Finance managers and front-desk staff who respond to payment disputes for a center.

On this page

Before you begin

  • The dispute must exist on a center that uses a supported payment processor. For dispute statuses, fees, cross-currency and partially won outcomes, and fund transfers, see Defend payment disputes β€” those base concepts are shared and are not repeated here.
  • You need the following permission:

Permission: Dispute Payments (on the Payments security object) β€” Required to view the Disputes management dashboard, open a dispute, and respond to it. A single permission governs configuration, the dashboard, and dispute history. Contact your administrator if you cannot open a dispute.

Availability: AI Dispute Manager is a paid add-on activated through the Zenoti Marketplace and configured per center. Standard mode is available without activation; AI with Manual and Instant AI modes require AIDM to be active and configured for the center. For current pricing and terms, see the Marketplace listing or contact your account manager.

How the three modes handle submission

The steps below for reviewing a dispute, adding a custom document, and downloading the evidence document are the same in every mode. What differs is when the package is built and when it is submitted. A center uses exactly one of three modes.

Mode When the package is built Cover letter When it submits automatically
Standard The basic documents (invoice, guest payment history, card receipt) are auto-populated as soon as a dispute is raised. Optional β€” you write it manually. There is no auto-generated cover letter. One day before the processor's due date, if you take no action.
AI with Manual The comprehensive AI package (AI cover letter, all required documents, past transaction history on the same card, and security checks) is built as soon as the dispute is raised. The AI drafts one automatically; you can edit it any time before submission. Automatically if you have not submitted before the response deadline.
Instant AI The AI builds the full package (AI cover letter, all required documents, past transaction history on the same card, and security checks) shortly after a dispute is raised. The AI drafts one automatically. Within about four hours, while you review and adjust.

When a dispute is raised in any mode, the system notifies the recipients configured for the center.

In AI with Manual mode, the AI builds the full package as soon as the dispute is raised. The mode in the per-center dropdown is labeled AI Manual-Review. You can review and edit the AI content, add or remove documents, and change the cover letter any time before submission. If you do not submit before the response deadline, the system submits the package automatically.

Worked example: A center uses AI Manual-Review. A chargeback is raised on July 1 with a response deadline of July 20. As soon as the dispute is raised, AIDM builds the full AI package β€” cover letter, required documents, past transaction history on the same card, and security checks. The finance manager reviews the package, edits the cover letter, and uploads two supporting files with + Add custom document. The manager does not manually submit before July 20, so the system submits the complete package automatically before the response deadline.

Important: Once the AI prepares a package, the dispute is recorded as AI-submitted even if you edit the content afterward. Editing an AI-built package does not change how the response is recorded.

In AI with Manual mode, the notification email sent to dispute recipients when a dispute is raised uses the subject line "Action recommended: Payment dispute received for invoice [invoice number] β€” AI evidence is ready". The email states that AIDM has already built a comprehensive evidence package, that the package can be reviewed and edited any time before submission, and that it will be submitted automatically on the date shown in the email if no one submits it first.

Understanding dispute urgency and status

Deadline urgency indicators

When you open a dispute that still requires a response, the detail page indicates how much time remains before the response deadline:

  • Warning state β€” fewer than 24 hours remaining before the deadline. Prioritize these disputes immediately.
  • Caution state β€” fewer than 72 hours remaining before the deadline. Review and act on these disputes soon.
  • No urgency indicator β€” more than 72 hours remaining. The dispute is within a normal response window.

Important: Response deadlines are set by the card network and vary per dispute. There is no fixed window that applies to all disputes.

Disputes that are no longer actionable

When you open a dispute whose status is no longer actionable, the dispute detail page displays a status-specific informational message explaining what the status means and whether any further action is required. The following statuses are non-actionable: Under Review, Won, Lost, Partially Won, Accepted, Evidence Saved, Responded, and Warning Closed. Review the message to understand the outcome and whether any steps remain on your side.

Non-defendable disputes

Some disputes are flagged as non-defendable. When this applies, all submission action buttons are suppressed on the dispute detail view β€” no defend or submit action is available. The evidence document and details panel remain visible for reference.

Pre-dispute (inquiry) disputes

A pre-dispute, or inquiry, is raised by the card network before a formal chargeback is filed. When an inquiry is actionable, the dispute detail page presents an Acknowledge Inquiry action in place of the standard defend action. Respond promptly β€” resolving an inquiry can prevent a chargeback from being filed.

Automatically defended disputes

When a dispute has already been automatically defended, the submission action button is shown in a disabled state. A tooltip on the button indicates that the dispute was automatically defended. You can still review the evidence document and details, but no further submission action is needed.

Steps

Open a dispute and review the evidence document

  1. From the Disputes management dashboard, select a dispute from the list. The dispute detail page opens with two areas: the evidence-document preview on the left and the details panel on the right.
  2. Check the deadline urgency indicator if the dispute is still actionable. If a warning or caution state is shown, prioritize your response accordingly.
  3. Review the system-generated evidence document, headed Defend the dispute. This document is generated for dispute defense, and you are expected to review and edit it before submission. It typically includes:
    • The guest's name, mobile number, and email.
    • The invoice date and the chargeback date.
    • The IP address and location associated with the transaction.
    • The chargeback context.
    • A transaction-details table (date, invoice number, transaction ID, amount, status, and AVS result).
    • The guest's payment history.
  4. If the dispute was processed through Adyen or Stripe and one or both security checks were positively confirmed, the evidence document includes a verification sentence:
    • Both AVS and CVV passed: "The transaction has also passed the AVS and CVC security check."
    • AVS only passed: "The transaction has also passed AVS (Address-Verification-System)."
    • CVV only passed: "The transaction was also CVV verified."
    • If neither check was positively confirmed, or if the dispute is on a different processor, no verification sentence appears.
  5. Use the zoom controls and the page indicator to move through the document.

Note: The evidence document preview shows one of three evidence tiers depending on what is available for the dispute: the submitted version (the package actually sent to the processor), the AI-assisted full package, or the Standard basic package. When you open a dispute, the preview automatically displays the most relevant version in that order.

Review the Dispute, Invoice, and Guest details

  1. In the details panel on the right, open the Dispute tab to review the dispute type, status, reason, created date, submitted-on date, the submitted-by indicator, and the dispute ID.
  2. Open the Invoice tab to review the transaction date, transaction amount, payment method, AVS (address verification) check result, invoice number, and transaction ID.
  3. Open the Guest tab to review the guest's name, email, and phone number.

Add a custom document to the evidence package

Regardless of the mode, you can strengthen the response by adding your own supporting documents alongside the system-generated evidence.

Note: Edit appears on the dispute detail page only while the dispute still needs a response, before its response deadline has passed, and when a system-generated document already exists for the dispute. If Edit is not shown, the package can no longer be changed.

  1. Select Edit, then in List of Documents select + Add custom document.
  2. Enter a name for the document.
  3. Upload the file (PNG, JPEG or PDF), then select Save. The custom document is included in the submission along with the system-generated evidence.

Each individual file and the assembled evidence package must stay within the size ceiling your payment processor accepts. For the accepted formats and the size figures that apply, see Evidence formats.

Important: In AI with Manual mode, documents you uploaded to the dispute's basic evidence form are listed under Documents uploaded by you in the evidence editor after the AI builds its package. They reach the AI submission only when uploaded again with + Add custom document.

Download the evidence document

  1. On the dispute detail page, use the download control in the evidence-document preview.
  2. Save the evidence document for your records before the response deadline.

Tips

  • Treat the system-generated evidence document as a starting point, not a final response. Review and edit it before it is submitted.
  • Add supporting custom documents β€” signed consent forms, communication logs, or proof of service β€” to make a stronger case.
  • Keep each supporting file small and legible. If the package exceeds the processor's size ceiling, remove or replace the largest attachments rather than adding more.
  • Processor dispute fees apply regardless of which mode a center uses. The mode affects how the response is prepared, not the fee. See Defend payment disputes for how fees and outcomes work.
  • In AI with Manual mode, review and edit the AI-built package promptly β€” you can adjust the content any time before submission, and the system submits automatically if you do not act before the response deadline.
  • Download the evidence document before the response deadline so you have a copy even after the dispute is submitted.
  • Act immediately on disputes showing a warning state (fewer than 24 hours remaining) β€” if the deadline passes without a response, the dispute may be automatically closed in the card network's favor.

Troubleshooting

  • The dispute still shows as AI-submitted even though I edited the package. This is expected. Once the AI prepares a package, the dispute is recorded as AI-submitted, whether or not you edit the content before submission.
  • I don't see Edit on the dispute detail page. Edit is available only while the dispute still needs a response, before its response deadline, and when a system-generated document exists for the dispute. If any of those conditions no longer holds, you cannot add or change documents.
  • The documents I uploaded earlier are listed but won't be submitted. In AI with Manual mode, files listed under Documents uploaded by you in the evidence editor are not automatically included in the AI submission. Add each one back with + Add custom document so it is part of the package that is submitted.
  • My file was rejected when I tried to upload it. Check that the file is a PNG, JPEG or PDF and that both the file and the assembled package are within the processor's size ceiling β€” see Evidence formats.
  • I can't open the Disputes management dashboard or a dispute. Confirm you have the Dispute Payments permission and that AI Dispute Manager is active for the center. Contact your administrator if either is missing.
  • I need to turn off AI dispute handling for a center. Deactivation is not self-service. Contact your Customer Success Manager to deactivate AIDM for a center.
  • The submit button is grayed out and shows a tooltip. If the tooltip indicates the dispute was automatically defended, no further action is needed β€” the response has already been submitted. If the dispute is flagged as non-defendable, no submission is possible for this dispute type.
  • The dispute detail page shows an informational message instead of action buttons. The dispute has reached a non-actionable status (for example, Under Review, Won, or Lost). Read the message to understand the outcome. No further response is required or possible from this view.
Was this article helpful?
Your feedback helps us improve our documentation.