Configure recurring billing and collections
Recurring billing settings control how and when the system collects membership payments. You configure billing frequency, collection timing, fee types, payment account requirements, and commission rules to ensure consistent revenue collection and a smooth guest experience.
Note: For conceptual background on membership billing models and collection workflows, see Memberships overview.
Before you begin
Permission: Edit (under Memberships) β Allows configuring recurring billing and collection settings for memberships.
Note: Permissions for this feature are controlled by your organization's security settings. Contact your administrator if you cannot access this feature.
- You need the Memberships > Edit permission to configure billing settings on an existing membership.
- The membership must already exist and be set to the Recurring type (see Create a membership).
- Confirm that your payment gateway is configured and active before setting up collection rules.
Steps
Billing frequency and collection timing
The system supports several fee types, each with its own frequency and timing configuration.
| Fee type | Description |
|---|---|
| Regular billing | The standard membership fee collected at the configured billing frequency. |
| Annual fee | An additional yearly charge collected on top of the regular billing. Configured directly on the membership. |
| Freeze fee | A fee charged when the guest freezes (suspends) the membership temporarily. Applies to recurring memberships only. |
| Buy-out fee | A fee charged when the guest buys out the remaining term of a commitment-based membership. |
| Decline fee | A fee charged to the guest when a scheduled payment is declined. |
| Cancellation fee | A fee charged when the guest cancels the membership. Configured through the cancellation and buy-out rules (see Configure cancellation and buy-out rules). |
The system supports two billing modes:
- Recurring billing β The system collects the membership fee at a regular frequency (weekly, biweekly, monthly, or quarterly) for the duration of the membership.
- Installment-based billing β The total membership cost is divided into a fixed number of installments. The system calculates the billing schedule automatically based on the membership expiry date and the installment count.
To configure billing frequency:
- Open the membership and navigate to the Define section.
- Set the billing mode:
- For recurring billing β Select the billing frequency (weekly, biweekly, monthly, or quarterly). The system collects the regular membership fee at this interval.
- For installment-based billing β Enter the total number of installments. The system calculates the billing frequency automatically based on the membership expiry date and the installment count.
- Set the First collection date to specify when the system creates the first billing invoice after enrollment.
- Set the Collection day to specify the day of the billing period when the system generates the invoice.
- Click Save.
Fixed billing dates
Fixed billing dates let you align membership collections to a specific day of the month, regardless of when the guest enrolled. This simplifies accounting and reconciliation.
There are two separate fixed billing date configurations:
Annual fee fixed billing date (membership Define section):
- Open the membership and navigate to the Define section.
- The Fixed billing date setting in this section applies to the annual fee only.
- Enable the toggle and select the month and day when the annual fee is collected.
- Click Save.
Recurring collection fixed billing date (Centers tab):
- Open the membership and navigate to the Centers tab.
- Each center can have its own Fixed billing date for recurring collections.
- Enter the day of month for regular billing at each center (for example, 1 for the first of each month or 15 for the fifteenth).
- Click Save.
Note: If a guest enrolls mid-cycle with a fixed billing date, the system prorates the first billing period. Subsequent collections occur on the fixed date.
Payment retry and dunning configuration
Payment retries automatically reattempt failed payments to reduce involuntary churn. The system retries the payment on the guest's saved payment method at configurable intervals. When all retry attempts are exhausted, dunning rules determine the next action (for example, suspend or cancel the membership).
Important: Payment retry and dunning settings are configured at the organization level, with an optional center-level override. These settings are not configured on the membership itself. To override for a specific center, navigate to the center-level configuration and adjust the values as needed.
To configure payment retry and dunning settings:
Navigate to the organization-level settings for membership billing.
Configure the following retry fields:
Field Description Max retries Enter the maximum number of times the system reattempts a failed payment. For example, 3 means the system tries up to three additional times after the initial failure. Retry interval (days) Enter the number of days between each retry attempt. For example, 3 means the system waits three days between each retry. Configure the dunning rules to control what happens after all retry attempts are exhausted. Dunning rules can automatically suspend, cancel, or flag memberships for review based on the number of failed attempts and the elapsed time since the first failure.
To override these settings for a specific center, navigate to the center-level configuration and adjust the values as needed.
Click Save.
Note: When all retry attempts fail and the dunning rules trigger a suspension, the membership status changes to Suspended automatically. Suspended memberships appear on the Suspended Memberships management page, where staff can take action (Charge, Cancel, or Waive). For details, see the collections workflow articles.
Payment account requirements
Recurring memberships require a saved payment method to process automatic collections. The following payment types are accepted:
| Payment type | Description |
|---|---|
| Credit card | The guest saves a credit card on file. The system charges this card automatically on each billing date. |
| ACH | The guest provides bank account details for Automated Clearing House (ACH) payments. |
| Cash | In specific cases, cash payments may be accepted for membership collections. The system generates invoices but does not auto-collect for cash payments. |
Additional payment account settings:
- Saved card required for recurring β When enabled, the guest must have a saved card on file to enroll in a recurring membership. The system blocks enrollment without a valid saved card.
- Expired card detection β The system monitors saved cards and alerts staff when a card on file is approaching its expiration date. Configure the notification window (for example, 30 days before expiry) to give staff time to collect updated payment information.
Annual fee collection
Annual fees are an additional yearly charge configured directly on the membership, collected on a separate schedule from the regular billing.
Open the membership and navigate to the Define section.
Set the annual fee amount. You can configure center-specific amounts on the Centers tab if needed.
Configure when the first annual fee is charged by selecting one of these three options:
Option Description From Sale Date The first annual fee is charged based on the date the membership is sold. Subsequent annual fees are charged on each anniversary of the sale date. From First Redemption The first annual fee is charged based on the date the guest first uses (redeems) a membership benefit. This delays the annual fee until the guest begins using their membership. After X Months/Days The first annual fee is deferred until after a configured number of months or days have elapsed from the membership start date. Enter the number and select months or days. Click Save.
Note: The annual fee is billed separately from the regular membership fee. The system creates a distinct invoice for the annual fee based on the collection timing you configure.
Commission configuration
Commission settings define how the system calculates and distributes commissions to staff members involved in membership sales and service.
Open the membership and navigate to the Commission section.
Select one of the two commission models:
Commission model Description Commission on sale Commission is earned when the membership is sold. The commission is calculated and attributed at the point of sale. Commission on redemption Commission is earned when the guest redeems membership benefits (for example, uses a service). The commission is calculated each time a benefit is redeemed. Configure the distribution rules to specify how commission is split among eligible staff (for example, the selling staff member, the servicing provider, or the front desk representative).
Click Save.