Manage disputed payments for memberships
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
- Understand the dispute lifecycle
- Flag a disputed payment
- Pause collections during a dispute
- Resolve a dispute
- Track all disputed memberships
- Related articles
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
- Open the member's profile.
- Navigate to the Memberships tab.
- Select the membership with the disputed payment.
- Click the membership-actions menu and select Mark as Disputed.
- Enter the dispute reference number (provided by your payment processor or the member's bank).
- Add notes summarizing the dispute reason and the steps your team is taking.
- 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:
- Open the disputed membership.
- Click Freeze Membership.
- 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.
- Enter the freeze duration (typically the expected dispute-resolution window — often 30 to 60 days).
- 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:
- Open the disputed membership.
- Click Unfreeze Membership (if you paused collections).
- Update the membership status to Active.
- Document the resolution in the membership notes.
- Resume normal collections on the next scheduled payment date.
If the dispute resolves in the member's favor:
- Open the disputed membership.
- Process any required refund through the standard refund workflow.
- Cancel the membership using Cancel Membership with the appropriate cancellation reason (for example, "Dispute resolved — member chargeback").
- 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.