Recurring billing and collections
Zenoti automatically processes recurring billing for memberships based on the configured billing frequency and payment accounts. This article covers how billing cycles work, how to manage collections, and how to handle payment failures.
Audience: Finance managers and administrators who monitor membership collections and resolve payment failures.
On this page
- Before you begin
- Why a newly sold membership may show as inactive
- How recurring billing works
- Collection types
- Payment accounts
- Collections dashboard
- Handle payment failures and suspended memberships
- Manage dunning invoices
- Plan changes and what to tell the member
- Tips
- Troubleshooting
Before you begin
- The Memberships row in the Marketing Manager section has no separate view check box. Opening the Collections Dashboard requires a role with Can access Administrator mode selected.
- You need Suspended Memberships under View Admin Reports in the Administrator section to open the Suspended Memberships page.
- You need the Manage membership dunning Invoices permission (under Memberships) to act on failed collections.
- You need Memberships > Edit permission to unlock and collect a pending invoice.
- You need Memberships > Cancel permission to cancel a suspended membership.
- You need Memberships > Waive permission to waive outstanding amounts.
- Payment retry and dunning settings are configured at the organization level with optional center-level overrides β not on the membership itself.
Why a newly sold membership may show as inactive
A membership shows as Inactive (Membership Status = InActive) while its recurring or proration invoice remains uncollected. This is the most common reason a newly sold membership does not appear active immediately after sale.
Resolution: Unlock the pending invoice and collect it. Once the invoice is closed, the membership activates and Membership Status transitions to Active.
Note: Do not create a new membership or re-sell the membership. The existing record is correct β it is waiting for the initial payment to be collected.
How recurring billing works
The system processes recurring billing through an automated scheduler:
- The scheduler identifies memberships with due collection dates.
- The system creates a recurring invoice for each billing cycle.
- The system attempts payment against the member's saved payment account.
- On success, the collection invoice is marked as closed and benefit credits accrue for the new billing cycle.
- On failure, the system logs the failure reason and updates the collection status.
For memberships with fixed billing dates, all collections for members at that center are aligned to the configured billing day.
Collection types
The system processes three types of membership collections:
| Collection type | Description |
|---|---|
| Regular recurring billing | Standard recurring membership charges based on billing frequency |
| Annual fee billing | Annual fee charges collected according to the annual fee timing configuration |
| Cancellation fee billing | Buy-out fees charged when a member cancels after the lock period |
Payment accounts
The system supports multiple payment account types for collection:
| Account type | Description |
|---|---|
| Credit Card (CC) | Standard credit card billing |
| ACH | Direct bank account debit |
| Check | Check-based payment |
| Shared card | A card shared between linked accounts |
The system detects expired cards and flags them for update before attempting collection.
Collections dashboard
The Collections Dashboard provides a centralized view of all membership collection activity.
- Navigate to Master data > Memberships > Membership Collections Dashboard.
- Set the Date Range (maximum 31 days).
- Select one or more centers using Select Centers.
- Choose a Group by option: Collection Date or Center Name.
The dashboard displays:
- Summary cards β Totals for Scheduled, Collected, Failed, and Cancelled collections, along with the Collection Rate and Top Decline Reason
- Collections By Status Report β A grid showing collection records grouped by their current status, with filtering, pagination, and export
- Collections By Attempts Report β A grid showing how many collection attempts have been made per invoice, with filtering, pagination, and export
- Collections By Failure Response Report β A grid categorizing failures by their decline reason, with filtering, pagination, and export
Note: Exporting data that contains personally identifiable information (PII) from the Collections Dashboard may require MFA verification.
Interpret the dashboard
Use the dashboard to drive daily action:
- Scheduled β Collections queued for the current period. A high scheduled count relative to collected indicates a processing run has not yet completed.
- Collected β Successfully processed payments. Compare against scheduled to calculate your effective Collection Rate.
- Failed β Payments that could not be processed. Drill into the Collections By Failure Response Report to identify the most common decline reasons and prioritize outreach.
- Cancelled β Invoices that were cancelled before collection was attempted.
For example, if the Top Decline Reason shows a high volume of expired card declines, filter the Suspended Memberships page by that failure type and contact those members to update their payment details before the next retry cycle.
Handle payment failures and suspended memberships
When a payment collection fails, the system follows the dunning process:
- The system logs the failure reason and updates the collection record. The invoice status transitions to Failed.
- The system retries the payment according to the dunning retry configuration (configured at the organization level with optional center overrides).
- After repeated consecutive failures, the membership Recurring Status automatically transitions to Suspended or Suspended Pending Tries, depending on the dunning configuration.
Important: Suspended status is automatic β it results from the dunning process. There is no manual suspend action.
Membership status dimensions during collections
Collections involve three independent status dimensions. Each has its own values and drives different system behavior:
Membership Status β drives benefit redemption eligibility:
| Status | Meaning |
|---|---|
| Active | Membership is active; benefits are redeemable |
| InActive | Membership is inactive |
| Suspended | Auto-suspended by repeated payment failures; redemption depends on org setting Allow redemption from suspended memberships |
| Failed | Invoice payment failed |
| Frozen | Paused by user or admin action |
| Cancelled | Cancelled by user or admin |
| Expired | Past expiry date |
| Closed | Explicitly closed by admin |
| NotStarted | Pre-activation state; pending initial collection |
Recurring Status β drives collection processing:
| Status | Meaning |
|---|---|
| Active | Collections are processing normally |
| Suspended | Auto-suspended; collection retries may continue per dunning config |
| Suspended Pending Tries | Suspended with additional retry attempts remaining |
| Failed | Collection has failed |
| Cancelled | Recurring billing has been cancelled |
| Frozen | Collection paused during a freeze period |
| Expired | Recurring term has ended |
Invoice Status β per recurring invoice:
| Status | Meaning |
|---|---|
| Pending | Invoice created; awaiting collection |
| Collected | Payment successfully collected; invoice closed |
| Failed | Collection attempt failed |
| Waived | Outstanding amount waived by admin |
| Cancelled | Invoice cancelled |
| Stopped | Collection stopped |
| Pending Direct Debit | ACH collection initiated; awaiting bank confirmation |
Note: Only invoices with a status of Collected are eligible for refund on cancellation. Outstanding or unpaid invoices cannot be refunded.
Manage suspended memberships
The Suspended Memberships page lets you view and act on memberships with failed payments.
Navigate to Memberships > Guest Memberships > Suspended Memberships.
Filter by:
- State: Suspended or Suspended Pending Tries
- Membership category
- Membership name
- Suspended-by user
- Date range
- Partial payments
For each suspended membership, you can take the following actions:
Action Description Charge Attempt to collect the outstanding amount. Select the payment method (Credit Card, ACH, or Check) and process the charge. Cancel Cancel the suspended membership. Waive Waive the outstanding amount. The system records the waive action. To process charges for multiple memberships at once, select multiple records and use the bulk charge operation.
Permission: Cancel (under Memberships) β Required to cancel a suspended membership.
Permission: Waive (under Memberships) β Required to waive an outstanding amount.
Worked example β resolving a batch of failed ACH collections
After a nightly processing run, 12 memberships appear on the Suspended Memberships page with a state of Suspended Pending Tries and a failure reason of "Insufficient funds." You filter the page by State: Suspended Pending Tries and Date range: last 7 days. You select all 12 records and use the bulk Charge operation, selecting ACH as the payment method. Eight succeed immediately; four remain failed. For the four remaining, you open each guest profile, confirm the bank account details are current, and schedule a manual retry for the following business day.
Manage dunning invoices
Permission: Manage membership dunning Invoices (under Memberships) β Required to manage dunning invoices.
Dunning invoices are the billing records created when recurring payments fail. You can view, charge, waive, or cancel dunning invoices from the Suspended Memberships page.
When you select Charge on a dunning invoice:
- The system loads the guest's saved payment accounts.
- Select the payment method: Credit Card, ACH, or Check.
- Confirm the charge. The system attempts collection and updates the invoice status.
When payment is received through any channel, close the collection invoice to record the payment and restore the membership to active status.
Plan changes and what to tell the member
Membership plan changes (upgrades and downgrades) follow three distinct paths. Understanding which path applies helps you set accurate expectations with the member.
Path 1 β Change gated behind a mandatory membership form
If the membership is configured to require a form submission before an upgrade or downgrade, the change cannot proceed until the form is completed.
What to tell the member: "Your plan change is pending. Please complete the required form. Once the form is submitted, the change will be processed."
Path 2 β Change that activates immediately
If no form is required and the change is configured to take effect immediately, the new plan becomes active as soon as the action is confirmed.
What to tell the member: "Your plan has been updated. The new plan is active now."
Path 3 β Future-dated change
If the change is configured to take effect on a future date (for example, at the next billing cycle), the current plan remains in force until the effective date. The system records the pending change.
What to tell the member: "Your plan change has been saved and will take effect on [effective date]. Your current plan continues until then."
Important: A member told only that "the change is saved" may interpret a future-dated change as a failure. Always confirm the effective date explicitly.
To cancel a pending upgrade, select Cancel Upgrade on the membership record, which opens a confirmation dialog titled Cancel Upgrade / Downgrade. To cancel a pending downgrade, select Cancel Downgrade from the same location.
Tips
- Monitor the Collections Dashboard daily. Filter by Failed status to identify memberships that need immediate attention before they reach the Suspended state.
- Use bulk charge for efficiency. When multiple memberships are suspended after a batch processing run, select all affected records on the Suspended Memberships page and use the bulk charge operation rather than processing each one individually.
- Verify payment account status before charging. The system flags expired cards. Confirm the guest has a valid payment account on file before attempting a manual charge to avoid additional failed attempts.
- Communicate plan change effective dates clearly. For future-dated plan changes, always tell the member the exact effective date so they do not interpret the pending state as an error.
- Use the Collections By Failure Response Report to prioritize outreach. Grouping failures by decline reason lets you identify systemic issues β for example, a spike in expired card declines β and address them in bulk rather than one at a time.
Troubleshooting
A newly sold membership is not active. The membership is waiting for its initial recurring or proration invoice to be collected. Unlock the pending invoice and collect it. Once closed, the membership activates. Do not create a duplicate membership.
A charge attempt on the Suspended Memberships page fails immediately. The guest's payment account may be expired or invalid. Open the guest profile, update the payment account details, then retry the charge from the Suspended Memberships page.
The Collections Dashboard shows no data for a selected date range. Verify the date range does not exceed 31 days. The dashboard enforces a maximum 31-day window. Adjust the range and reload.
A membership remains in Suspended status after a successful charge. The invoice status should update to Collected after a successful charge. If the membership Recurring Status has not returned to Active, check whether additional unpaid invoices exist for earlier billing cycles. Each outstanding invoice must be collected or waived individually.
A plan change is not visible to the member. If the change is future-dated, the current plan remains active until the effective date. Confirm the effective date with the member. If the change required a mandatory form and the form has not been submitted, the change will not proceed until the form is completed.
The Suspended Memberships page shows a membership but the Charge action is unavailable. Verify you have the Manage membership dunning Invoices permission. Without this permission, the action controls are not accessible.