Manage recurring collections
Use the Collections Dashboard and Suspended Memberships page to monitor payment collections, resolve failures, and manage suspended memberships for recurring membership billing.
Audience: Finance managers and administrators who oversee recurring membership collection operations.
On this page
Before you begin
Note: 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; opening the Suspended Memberships page requires the check box below.
Permission: Suspended Memberships under View Admin Reports in the Administrator section β Required to open the Suspended Memberships page.
Permission: Edit (under Memberships) β Required to modify collection dates or act on memberships.
Permission: Cancel (under Memberships) β Required to cancel suspended memberships.
Permission: Waive (under Memberships) β Required to waive outstanding collection amounts.
Permission: Memberships Payment Report (under Marketing) β Required to view the Memberships Payment report (V2). Find it in the Reports(V2) section of the role.
- Payment retry and dunning settings are configured at the organization level with optional center-level overrides. They are not configured on the membership itself.
- The Collections Dashboard date range is limited to a maximum of 31 days per query.
- Bulk charge operations are available on the Suspended Memberships page for processing multiple failed collections at once.
Steps
View the Collections Dashboard
- Navigate to Master data > Memberships.
- From the Memberships listing, select Membership Collections Dashboard.
- Set the Date Range β the maximum span is 31 days.
- Use Select Centers to choose one or more centers to include.
- Under Group by, select either Collection Date or Center Name to control how results are grouped in the grids below.
- The dashboard loads automatically when filters are applied.
Note: The Collections Dashboard covers three collection types: regular recurring billing, annual fee billing, and cancellation fee billing.
Read the summary cards
The top of the dashboard displays four summary cards. Each card shows the total monetary amount for collections in the selected date range and centers.
| Card | What it shows |
|---|---|
| Scheduled | Collections that are due but not yet processed in the period |
| Collected | Collections that were successfully processed |
| Failed | Collections where the payment attempt was unsuccessful |
| Cancelled | Collections that were cancelled before processing |
The Collection Rate and Top Decline Reason indicators appear alongside the summary cards to give a quick view of collection health for the selected period.
Drill into collection detail grids
Below the summary cards, the dashboard displays three advanced grid view sections. Each section supports filtering, pagination, and export.
Collections by Status Report
Shows each collection record grouped by its current invoice status. Use this grid to see how many invoices are in each state (for example, Pending, Collected, Failed, Waived).
Collections by Attempts Report
Shows how many collection attempts have been made per invoice. Use this grid to identify memberships that have been retried multiple times without success.
Collections by Failure Response Report
Shows the failure responses returned by the payment processor, grouped by reason. Use this grid to identify systemic issues β for example, a high volume of expired-card declines β and prioritize outreach.
To export data from any grid:
- Select the grid section you want to export.
- Select Export to Excel or the CSV export option.
- If the export includes personally identifiable information (PII), you will be prompted to complete multi-factor authentication (MFA) before the file downloads.
Handle a failed collection on the Suspended Memberships page
When recurring collection attempts fail repeatedly, the membership transitions to a Suspended state and appears on the Suspended Memberships page. This is an automatic system-driven state β it is not a manual action.
Important: A membership in Suspended state is distinct from a frozen membership. Freezing is a deliberate pause initiated by a guest or administrator. Suspension is automatic, triggered by repeated payment failures during dunning.
Navigate to the Suspended Memberships page:
Navigate to Memberships > Guest Memberships > Suspended Memberships.
Filter suspended memberships:
Use the available filters to locate the records you need to act on:
| Filter | Description |
|---|---|
| State | Filter by Suspended or Suspended Pending Tries |
| Membership category | Narrow to a specific membership category |
| Membership name | Narrow to a specific membership |
| Suspended-by user | Filter by the user or system process that triggered the suspension |
| Date range | Filter by the date the membership was suspended |
| Partial payments | Filter to show memberships with partial payment history |
Act on a single suspended membership:
Locate the membership record in the grid.
Select the membership to open its detail.
Choose one of the following actions:
- Charge β Loads the guest's saved payment accounts. Select a payment method (credit card, ACH, or check) and process the collection. If the guest has a shared card on file, that option is also available. The system checks for expired cards before processing.
- Waive β Waives the outstanding amount. The system records the waive action and the reason. You need the Waive permission (under Memberships) to perform this action.
- Cancel β Cancels the suspended membership. You can optionally specify a future termination offset so the membership remains active until a defined date. You need the Cancel permission (under Memberships) to perform this action.
Process a bulk charge:
- On the Suspended Memberships page, select the checkboxes for multiple membership records.
- Select the bulk charge option.
- The system processes the charge for each selected membership using the guest's saved default payment method.
Note: Bulk charge uses each guest's saved default payment account. Verify that payment accounts are current before running a bulk charge to reduce the number of re-failures.
Worked example: A finance manager filters the Suspended Memberships page by State: Suspended and Date range: last 7 days, finding 12 memberships. She selects 10 whose guests have valid credit cards on file and runs a bulk charge. For the remaining 2 with expired cards, she contacts the guests individually to update their payment information, then charges each manually after the new card is saved.
Identify hard declines
Hard declines occur when a payment fails for a permanent reason β for example, an expired card, a closed account, or a card reported lost or stolen. Unlike soft declines (temporary failures such as insufficient funds), hard declines cannot be resolved by retrying the same card.
The system logs the failure reason for each collection attempt. Use the Collections by Failure Response Report grid on the Collections Dashboard to identify hard declines in bulk. On the Suspended Memberships page, the payment account status is visible when you open a membership record β expired cards are flagged.
For memberships with hard declines:
- Contact the guest to request updated payment information.
- Once the guest provides a new card, update the payment account on the guest's membership.
- Return to the Suspended Memberships page and select Charge to process the collection using the new account.
Edit the next collection date
You can shift the date on which a recurring collection is processed. The edit dialog offers two scope options with different effects.
Important: The two scope options have permanently different consequences. Choose carefully β All future collections is frequently selected to defer one month's payment, but it shifts every subsequent collection and causes ongoing schedule drift that may be difficult to notice until several billing cycles have passed.
To edit the next collection date:
Open the guest's membership record.
Locate the recurring collection schedule.
Select the option to edit the collection date.
In the dialog, choose one of the following scope options:
Option Effect Only next collection Shifts the single upcoming collection to the new date, then returns to the original billing anchor for all subsequent collections All future collections Permanently moves the billing anchor to the new date β all future collections follow the new schedule
Important: Choosing All future collections permanently changes the billing anchor. This option is frequently selected to defer one month's collection, but it causes every subsequent collection to shift as well. If you intend to defer only one payment, always select Only next collection.
To restore the original schedule after an accidental anchor change:
- Open the guest's membership record.
- Edit the collection date again.
- Select All future collections and enter the original billing date to reset the anchor.
Understand the Next Try field and pending-state blocks
When a collection fails, the system schedules a retry. The Next Try field on the collection record shows the date on which the failed collection will be retried automatically.
Key behaviors to understand:
- A collection that is in a Pending or Pending Direct Debit state is actively being processed or queued. While a collection remains in this state, manual collection is blocked β you cannot initiate a charge for that invoice until the pending state resolves.
- If a collection has been sitting in a pending state well past its Next Try date, this is an escalation trigger β do not wait for it to resolve on its own.
On-screen messages that indicate a pending-state block:
When you attempt to manually collect on a membership that has a pending collection, you see one of the following on screen:
- Auto-payment in progress. Please wait a few moments and then refresh the page. β The invoice shows this banner while an automatic payment attempt is underway. Manual collection is blocked until the attempt completes or times out.
- Pending - submitted for batch processing β The collection status shows this value while the collection sits in the payment processor's batch queue and has not yet settled. Manual collection is blocked until the batch settles.
If you see either of these and the Next Try date has already passed, escalate the issue rather than waiting. Contact your payment processor or Zenoti support to investigate the stuck collection.
Tips
- Use the Group by filter to compare centers. Grouping by Center Name lets you compare collection rates across locations side by side. Grouping by Collection Date is better for identifying whether failures cluster around specific billing dates.
- Run the Collections Dashboard before bulk charge. Review the Collections by Failure Response Report grid before running a bulk charge on the Suspended Memberships page. If a large proportion of failures are hard declines (expired or closed cards), bulk charging will re-fail those records and may trigger additional decline fees. Address hard declines individually first.
- Prefer "Only next collection" when deferring a single payment. Selecting All future collections when you intend to defer only one month permanently shifts the billing anchor. Use Only next collection to avoid unintended schedule drift for all future charges.
- Export data for reconciliation. Use Export to Excel from each grid section to produce a record of collections by status, attempts, and failure reason. These exports support month-end reconciliation and can be shared with finance teams. MFA is required when the export includes PII.
- Check the Next Try date before escalating. A collection sitting in a Pending state with a Next Try date in the past is a signal to escalate β not to wait. Match the on-screen message to the cause described in the Troubleshooting section below before contacting support.
Troubleshooting
The Collections Dashboard shows no data after I apply filters.
Verify that the date range does not exceed 31 days. The dashboard enforces a maximum 31-day window; ranges wider than this return no results. Also confirm that the selected centers have recurring membership collections scheduled in the chosen period.
A membership appears on the Suspended Memberships page but I cannot charge it β the invoice shows "Auto-payment in progress. Please wait a few moments and then refresh the page."
The collection is in a Pending state, meaning an automatic payment attempt is underway. Manual collection is blocked while the attempt is active. Wait for the attempt to complete. If the Next Try date has already passed and the status has not changed, escalate to your payment processor or Zenoti support β the collection may be stuck in the batch queue.
A membership appears on the Suspended Memberships page but I cannot charge it β the collection status shows "Pending - submitted for batch processing."
The collection has been submitted to the payment processor's batch queue but has not yet settled. Manual collection is blocked until the batch settles. If the Next Try date has passed and the status remains unchanged, escalate rather than waiting β this indicates the batch may not have settled correctly.
After selecting "All future collections" to defer one payment, subsequent charges are now on the wrong date.
Selecting All future collections permanently moved the billing anchor. To restore the original schedule, open the membership, edit the collection date again, select All future collections, and enter the original billing date. This resets the anchor for all future collections.
A guest's card is flagged as expired on the Suspended Memberships page, but the guest says they have a new card.
The new card must be saved to the guest's membership payment account before you can charge it. Update the payment account with the new card details, then return to the Suspended Memberships page and select Charge.
The bulk charge ran but some memberships are still suspended.
Memberships that remain suspended after a bulk charge had payment failures β either the card was declined again, or the account had a hard decline (expired or closed). Open each remaining suspended membership individually, review the failure reason, and take the appropriate action: update the payment account for hard declines, or retry for soft declines.