Payment Dispute Management
Zenoti Payments displays all disputes (also known as chargebacks) raised against your organization in a single list, and gives authorized staff the tools to accept or defend each one. This article explains how to browse disputes, view their details and event history, and take action on each dispute.
Audience: Center managers and payment administrators who manage disputes on behalf of the organization.
On this page
- View the dispute list
- Open a dispute detail view
- Accept a dispute
- Defend a dispute
- Build the dispute evidence package
- Review membership payment history in the evidence package
- Review package payment history in the evidence package
- Preview dispute evidence
- Upload a custom evidence attachment
- Worked example β disputing a membership billing chargeback
- Manage dispute evidence
- Tips
- Troubleshooting
Before you begin
Your organization must be onboarded to Zenoti Payments with an active payment processor.
You need the following permission:
Permission: Dispute Payments (under Payments) β required to view the dispute list, open dispute details, accept a dispute, defend a dispute, and manage dispute evidence. Admin path: Configuration > Security > Security roles > [your role] > Permissions > Payments > Dispute Payments
The dispute list is scoped to your organization. If your role restricts you to specific centers, the list reflects only the centers you have access to.
Steps
View the dispute list
The dispute list shows all open and closed disputes across your organization.
Navigate to Payments > Disputes management.
The page heading is Disputes.
Use the status tabs to narrow the list:
Tab What it shows All Every dispute regardless of status Needs Response Disputes requiring action from your organization Under Review Disputes currently being reviewed by the payment network Won Disputes resolved in your favor Lost Disputes resolved in the guest's favor To narrow the list further, select Filter and configure one or more of the following criteria:
- Status
- Dispute Type
- Center
- From (date)
- To (date)
Select Apply to apply the filters. Select Reset to clear all filter values and return to the unfiltered list.
To jump to a common view without setting filters manually, use the Quick Views panel:
Quick View What it shows All Disputes The full unfiltered dispute list Needs Response (7 days) Disputes that need a response within 7 days Defense Due Today Disputes whose defense deadline is today Won (Last 30 days) Disputes won in the past 30 days To access a specific dispute, select View Details on the relevant row.
Note: When a center filter is applied, center access enforcement is fail-closed. If your security role does not include a center, that center's disputes are not shown even if you apply its filter explicitly.
Open a dispute detail view
Each dispute has a full detail view that includes all dispute information and an event history log.
- In the dispute list, select View Details on the dispute you want to review.
- The detail view opens, showing:
- Full dispute information, including the disputed amount, transaction date, guest details, and payment provider reference.
- Event history β a log of all actions and status changes for this dispute, in chronological order.
Accept a dispute
Accepting a dispute signals to the payment provider that your organization does not contest the chargeback. The disputed amount is debited from your account after acceptance. Use this action when you determine the guest's claim is valid or when contesting is not cost-effective.
Important: Accepting a dispute is irreversible. Once you confirm, the disputed amount is debited and your organization cannot later choose to defend the same dispute. Review the event history and dispute details before proceeding.
- Open the dispute detail view for the dispute you want to accept.
- Select Accept at the top of the dispute page, or select Accept Dispute in the action area.
- Select Confirm.
Zenoti sends the acceptance to the payment provider. The disputed amount is debited and the dispute can no longer be contested.
Defend a dispute
Defending a dispute submits evidence to the issuing bank showing that the charge was valid. Zenoti generates the evidence package automatically.
Important: Respond within the deadline shown on the dispute detail view. The deadline is set by the card network for each dispute and varies by case. Missing the deadline forfeits your right to contest the chargeback.
Important: Defending a dispute is irreversible. Once you confirm, the evidence is submitted and the action cannot be undone.
Open the dispute detail view for the dispute you want to defend.
Review the event history and dispute information to confirm you have grounds to contest.
Select Defend at the top of the dispute page, or select Defend Dispute in the action area.
Note: For a pre-dispute inquiry, the button is labeled Acknowledge Inquiry instead of Defend.
Select Confirm.
The dispute is marked as defended only after the payment provider confirms receipt of the evidence submission. If the provider has not yet acknowledged, the status does not update and you can monitor progress in the event history log.
Note: Evidence packages are also generated automatically by a background process. If a dispute already has a submitted evidence artifact, the background process skips it to avoid duplicate submissions. Per-dispute failures in the background process are logged and do not stop processing of remaining disputes.
Build the dispute evidence package
Zenoti assembles a structured evidence PDF when you submit a dispute response. The package is built automatically from transaction data, but understanding its contents helps you ensure all supporting information is in place before you submit.
The evidence PDF includes:
- Transaction summary β the amount, date, entry mode (chip, swipe, contactless), and Zenoti transaction ID
- AVS, CVV, and 3DS check results β the verification outcomes recorded at the time of the transaction
- Guest contact information β name, email address, and phone number from the guest profile
- IP address β the IP address captured when the transaction was initiated online (where applicable)
- Dispute date and transaction date
- A cover letter β describing your business and the transaction context
- Past guest transaction history β prior transactions from the same guest at your organization
- Supporting documents β membership payment history or package payment history, when applicable (see the sections below)
Note: If your organization has the AI evidence feature enabled, Zenoti generates an AI-assisted backbone (full document set plus an AI-drafted cover letter) and merges it with any saved edits you have made β including cover letter revisions, per-section edits, and custom document attachments β into the final submitted evidence PDF.
To confirm what has been captured for a specific dispute before you submit:
- Navigate to Payments > Disputes management.
- Locate the dispute in the list and select View Details.
- Review the evidence PDF inline on the dispute page (see Preview dispute evidence below).
Review the cover letter and transaction summary for accuracy before proceeding to submission.
Review membership payment history in the evidence package
When the disputed transaction is linked to a membership recurring collection, Zenoti automatically includes a Membership Payment History document in the evidence package. This document gives the card network or issuing bank a complete picture of the guest's billing relationship with your organization.
The Membership Payment History document includes the following membership details:
| Field | Description |
|---|---|
| Membership name | The name of the membership plan |
| Code | The unique membership code |
| Start date | When the membership became active |
| End date | When the membership expires or is scheduled to expire |
| Membership status | Current status of the membership |
| Collection status | Current recurring collection status |
| Recurring amount | The amount collected per billing cycle |
| Default payment type | The payment method on file for recurring collections |
| Scheduled payment date | The date the disputed payment was scheduled |
| Sale center | The center where the membership was sold |
| Sold by | The employee who made the membership sale |
| Payment frequency | How often recurring collections occur |
| Termination date | If the membership has been terminated, the termination date |
Below the membership details, the document includes a windowed table of recurring collections surrounding the disputed transaction. This table shows:
| Column | Description |
|---|---|
| Attempts | Number of collection attempts for that billing period |
| Invoice number | The invoice associated with each collection attempt |
| Receipt number | The receipt number, if the collection succeeded |
| Due date | When the payment was due |
| Collection date | When the collection was attempted or completed |
| Amount paid | The amount collected |
| Status | The outcome of the collection attempt |
| Next retry date | If the collection failed, when the next attempt is scheduled |
| Collection type | Whether the collection was a standard recurring payment, dunning retry, or other type |
No action is required to include this document β Zenoti adds it automatically when the disputed invoice is a membership recurring collection.
Review package payment history in the evidence package
When the disputed transaction is linked to a package payment schedule, Zenoti automatically includes a Package Payment History document in the evidence package.
The Package Payment History document displays the complete collection schedule for the package as a table:
| Column | Description |
|---|---|
| Attempts | Number of collection attempts for that installment |
| Collection date | When the installment was collected or attempted |
| Amount | The installment amount |
| Payment type | The payment method used for that installment |
| Status | The outcome of the collection attempt |
At the bottom of the document, a footer shows the total scheduled amount across all installments in the package schedule.
As with membership history, this document is added automatically β no action is required when the disputed invoice is a package installment payment.
Preview dispute evidence
Before submitting your evidence package, you can preview the PDF inline on the dispute page to confirm it is complete and accurate.
Permission: You need the Dispute Payments permission under Payments to preview dispute evidence. Admin path: Configuration > Security > Security roles > [your role] > Permissions > Payments > Dispute Payments
To preview evidence for a dispute:
- Navigate to Payments > Disputes management.
- Locate the dispute and select View Details.
- The evidence PDF is shown inline on the dispute page.
- Confirm that the transaction summary, cover letter, and supporting documents are accurate before proceeding.
Note: The Documents table in the Edit Evidence form includes a View option that opens the evidence PDF. Custom evidence attachments cannot be viewed from this location β they are accessible only through the inline display on the dispute page.
Upload a custom evidence attachment
You can supplement the system-generated evidence package with your own files β for example, a signed service agreement, a photograph of the guest's ID, or an internal service record.
Important: Custom attachments are added to (merged with) the evidence package. Uploading a custom file does not overwrite the system-generated evidence.
Important: You cannot upload a custom attachment once evidence has been submitted. Ensure your custom document is ready before you submit the dispute.
Permission: You need the Dispute Payments permission under Payments to upload evidence attachments. Admin path: Configuration > Security > Security roles > [your role] > Permissions > Payments > Dispute Payments
To upload a custom evidence attachment:
Navigate to Payments > Disputes management.
Locate the dispute and select View Details.
Select Upload Custom Evidence.
Choose your file. You can click to upload or drag and drop the file into the upload area.
Accepted file types and size limits:
Processor Accepted types Maximum size Stripe PDF, PNG, JPG, DOC 4.5 MB Adyen PDF, PNG, JPG, DOC 2 MB Other processors PDF, PNG, JPG, DOC 10 MB Confirm the upload.
The custom file is added to the evidence package and will be included when you submit the dispute response.
Tip: Preview the evidence package after uploading your custom file to verify that the merged PDF appears as expected before you submit.
Worked example β disputing a membership billing chargeback
A guest disputes a $120 recurring membership payment, claiming they did not authorize it. Here is how the evidence package is assembled and reviewed:
- You navigate to Payments > Disputes management and select View Details on the dispute for invoice #INV-00841, dated March 15.
- Zenoti has automatically included a Membership Payment History document showing:
- Membership: Gold Monthly β started January 5, currently Active
- Recurring amount: $120.00 / month
- Collected on: March 15 (2nd attempt β first attempt on March 1 failed due to an expired card)
- The windowed table shows January 15 ($120, Collected), February 15 ($120, Collected), March 1 (Failed, retried), March 15 ($120, Collected)
- You review the evidence PDF inline on the dispute page. The cover letter confirms the guest enrolled online and the transaction was authenticated.
- You select Upload Custom Evidence and upload a PDF copy of the membership agreement the guest signed at enrollment.
- After confirming the merged PDF is accurate, you select Defend Dispute and then Confirm to submit the dispute response.
Manage dispute evidence
When you submit a response to a dispute (also called a chargeback), Zenoti lets you control the evidence that goes to the payment network. You can attach custom documents, edit the merchant-facing evidence form, replace the generated evidence PDF, and trigger evidence submission β all from the dispute record.
Permission: You need the Dispute Payments permission to perform these actions. Admin path: Configuration > Security > Security roles > [your role] > Permissions > Payments > Dispute Payments
Save merchant-edited evidence form data
Selecting Edit Evidence opens the evidence form, which includes three sections: Transaction Details, Cover Letter, and Documents. Content you save in this form takes precedence over system-generated content when the final evidence PDF is produced.
- Open the dispute record from Payments > Disputes management.
- Select Edit Evidence.
- Edit the fields across Transaction Details, Cover Letter, and Documents with the information you want to include β for example, service descriptions, guest interaction notes, or policy references.
- Select Save Evidence to persist the form data against the dispute.
When the evidence PDF is generated, the system uses your saved form data in place of any automatically populated content.
Note: The Delete option in the Documents table of the Edit Evidence form is disabled. You cannot remove an uploaded evidence file from this location.
Tip: Save the form data before triggering evidence submission. Unsaved changes are not included in the merged PDF.
Replace the evidence document
You can replace the current evidence document for a dispute using Replace Document. This option is available only while the dispute can still be acted on, evidence exists, and the dispute was not automatically defended.
Replace Document opens a dialog with two options:
- Upload Custom PDF β upload a single PDF you have prepared outside Zenoti.
- Use System Generated β regenerate the evidence PDF from current dispute data and any saved form edits.
Select your preferred option and then select Replace to apply the change.
Important: If you upload a custom PDF using Replace Document, selecting Use System Generated afterward will replace your custom file with a freshly generated version. Decide on your approach before submitting.
Submit evidence to the payment provider
When you are ready to respond to a dispute, you can trigger evidence submission from the dispute record. Zenoti selects the correct PDF automatically based on whether the AI evidence feature is active for your organization.
- When the AI evidence feature is active, the AI-generated PDF is submitted and the submission is recorded as AI-submitted.
- When the AI evidence feature is not active, the standard (non-AI) generated PDF is submitted.
To submit evidence:
- Open the dispute record from Payments > Disputes management.
- Confirm that the evidence document reflects the content you intend to submit. Check that any merchant-edited form data is saved and any custom PDF is in place.
- Select Defend at the top of the dispute page, or select Defend Dispute in the action area, then select Confirm.
Zenoti sends the selected PDF to the payment provider. After a successful submission, an immutable copy of the submitted bytes is stored and a pointer to that stored copy is recorded on the dispute record.
Important: After the payment provider accepts the submission, Zenoti stores a permanent, uneditable copy of what was submitted. If a storage failure occurs after the provider has already accepted the submission, the failure is logged but the submission stands β the provider's acceptance is not reversed.
Note: You cannot re-submit evidence after a successful submission unless the payment provider's workflow permits a resubmission. Check the dispute record for the current status and the network's response deadline before acting.
Worked example
Scenario: A guest disputes a $150 service invoice. The dispute record shows the status as Initiated. You want to respond with your own documentation.
- Navigate to Payments > Disputes management and select View Details on the dispute.
- Select Edit Evidence. In the Cover Letter section, enter the guest's appointment history, the signed service agreement reference, and your no-refund policy text. Select Save Evidence.
- Select Upload Custom Evidence and upload the signed service agreement as a PDF.
- Review the evidence PDF inline on the dispute page. Because you prefer your own compiled document, select Replace Document, choose Upload Custom PDF, upload your final compiled PDF, and select Replace.
- Select Defend Dispute, then Confirm.
- Zenoti submits the custom PDF to the payment provider. The submission type is recorded and an immutable copy is stored against the dispute record.
Tips
- Check the provider dispute identifier first. When a guest contacts you about a chargeback, locate the dispute by its provider dispute identifier to ensure you are acting on the correct transaction.
- Use the event history log. The event history shows every status change and action taken on a dispute. Review it before deciding whether to accept or defend β it may reveal prior correspondence or automated activity.
- Filter by center before bulk review. If your organization has multiple centers, apply the center filter before reviewing disputes to focus on one center at a time and avoid acting on the wrong record.
- Do not wait for the background evidence job alone. Although Zenoti generates evidence packages automatically, you should monitor each dispute's status and confirm that the provider has acknowledged receipt before assuming the defense is complete.
- Understand the outcome states. A dispute status of Won means the payment provider ruled in your favor; Lost means the chargeback stands and the funds are returned to the guest. Rejected means the provider rejected the dispute filing itself; Invalid means the dispute record is not actionable.
Troubleshooting
| Symptom | Likely cause | Resolution |
|---|---|---|
| The dispute list is empty but you expect open disputes | Your role may be restricted to centers that have no dispute activity, or the processor has not yet reported disputes to Zenoti | Verify your center filter is set to All and confirm with your payment processor that disputes have been filed |
| The Accept or Defend button is not visible | Your security role does not include the Dispute Payments permission | Ask your administrator to grant the Dispute Payments permission under Configuration > Security > Security roles |
| The dispute status did not change after you selected Defend Dispute and confirmed | The payment provider has not yet confirmed receipt of the evidence package | Wait a few minutes, then refresh the dispute detail view; if the status remains unchanged, contact Zenoti Support |
| A dispute you expected to find does not appear in the list | The dispute may be associated with a center your role does not have access to | Ask your administrator to check the center filter or adjust your role's center access |
| The center filter shows fewer centers than expected | Your security role enforces center access restrictions | Contact your administrator to confirm which centers are included in your role |
| Upload Custom Evidence is not available | Evidence has already been submitted for this dispute | Upload is disabled once evidence is submitted; no further custom files can be added |