ZenotiHelp

Manage disputed payments for memberships

ZTZenoti Docs Team Updated June 8, 2026 2 min readGuide

When a member disputes a recurring membership payment (chargeback, payment processor dispute, manual investigation), Zenoti supports a managed workflow for pausing collections, marking the dispute status on the membership, and restoring normal billing once the dispute resolves.

Audience: Front-desk staff, membership managers, and finance teams who handle membership-payment disputes.


On this page


Before you begin

  • The setting Enable centers to modify membership status for disputes must be ON at the organization level (see Enable centers to modify membership status for disputes).
  • Your user role must have Edit Membership permission and the Manage Membership Status action permission.
  • Confirm the underlying payment-processor dispute has a reference number you can record on the membership.

Understand the dispute lifecycle

A typical membership payment dispute moves through these states:

State What it means
Active Membership is collecting normally; no dispute flagged.
Disputed A payment is under dispute. Collections may be paused per your center's policy.
Frozen Membership is paused for the duration of the dispute review. Benefits are limited per Freeze Type configuration.
Resolved (Active) Dispute concluded in the organization's favor. Membership returns to normal collection.
Resolved (Cancelled) Dispute concluded in the member's favor or member-initiated cancellation. Membership is cancelled.

Flag a disputed payment

  1. Open the member's profile.
  2. Navigate to the Memberships tab.
  3. Select the membership with the disputed payment.
  4. Click the membership-actions menu and select Mark as Disputed.
  5. Enter the dispute reference number (provided by your payment processor or the member's bank).
  6. Add notes summarizing the dispute reason and the steps your team is taking.
  7. Click Save.

The membership status changes to Disputed. The membership tab on the member's profile displays a Disputed badge.

Pause collections during a dispute

To avoid further automated charges while the dispute is under review:

  1. Open the disputed membership.
  2. Click Freeze Membership.
  3. Select a Freeze Type that aligns with your dispute policy. For example, choose the option that allows benefit use while skipping payments during the freeze period.
  4. Enter the freeze duration (typically the expected dispute-resolution window — often 30 to 60 days).
  5. Click Confirm.

The next scheduled collection is suspended until the freeze ends or you manually unfreeze the membership.

Resolve a dispute

When the payment processor or finance team concludes the dispute review:

If the dispute resolves in the organization's favor:

  1. Open the disputed membership.
  2. Click Unfreeze Membership (if you paused collections).
  3. Update the membership status to Active.
  4. Document the resolution in the membership notes.
  5. Resume normal collections on the next scheduled payment date.

If the dispute resolves in the member's favor:

  1. Open the disputed membership.
  2. Process any required refund through the standard refund workflow.
  3. Cancel the membership using Cancel Membership with the appropriate cancellation reason (for example, "Dispute resolved — member chargeback").
  4. Document the resolution and the refunded amount in the membership notes.

Track all disputed memberships

To monitor disputes in progress at your organization:

  • Use the Suspended Memberships report (under Reports > Memberships) — it lists every membership that is currently paused, including those paused for disputes.
  • Filter the Members list by Membership Status: Disputed for a quick view of active disputes.
  • Use the Membership Collections Failed report to identify members whose collections have started failing — frequently a leading indicator of an upcoming dispute.
Was this article helpful?
Your feedback helps us improve our documentation.