Recurring Subscriptions
Recurring subscriptions allow you to set up automatic recurring payments via Stripe, enabling clients to be charged periodically (daily, weekly, monthly, or yearly) for their subscription.
Prerequisites
Before setting up recurring subscriptions, ensure that:
- The Stripe payment provider plugin is installed and configured
- Stripe is set as your preferred payment provider in payment settings
- You have created Products and Prices in your Stripe account
Learn how to create Products and Prices in Stripe: Stripe Products and Prices Documentation
How to Create a Recurring Subscription
- Navigate to your company page and go to the "Subscriptions" section under "Plugins".
- Click "New subscription".
- Fill in the basic subscription details:
- Name: Enter a name for your subscription (e.g., "Monthly Gym Membership").
- Services: Select the services included in this subscription.
- Resources: Choose the resources available for this subscription.
- Configure any Limits as needed (days, hours, visits, max duration).
Enabling Recurring Payments
- In the subscription form, locate the Recurring Subscription section.
- Toggle the "Recurring Subscription" switch to enable automatic recurring payments.
When recurring payments are enabled, the subscription duration is automatically calculated based on your recurring interval settings and cannot be manually edited.
- Configure the recurring payment settings:
Interval: Choose how often the subscription will renew:
- Day
- Week
- Month
- Year
Count: Set the interval multiplier (e.g., "2" with "Month" = every 2 months).
- Link your Stripe Product and Price:
Stripe Product ID: Enter the Product ID from your Stripe dashboard (starts with prod_).
Stripe Price ID: Enter the Price ID from your Stripe dashboard (starts with price_).
You can find your Product and Price IDs in your Stripe Dashboard under Products. Each price will have a unique ID that defines the billing interval and amount.
Additional Settings
-
Configure Rollover Settings if you want unused visits to carry over to the next billing period. Learn more about rollover settings.
-
Click "Create" to save your recurring subscription.
How Recurring Subscriptions Work
When a client purchases a recurring subscription:
- They are charged immediately for the first billing period via Stripe.
- Stripe automatically creates a subscription that will charge the client at the specified interval (e.g., every month).
- The subscription remains active as long as payments are successful.
Common Use Cases
Recurring subscriptions are ideal for:
- Gym memberships: Monthly access to facilities with a set number of visits
- Class packages: Weekly or monthly packages that auto-renew
- Therapy sessions: Monthly subscriptions for a certain number of sessions
- Coworking spaces: Monthly desk access with automatic renewal
- Wellness programs: Ongoing access to services with regular billing
Troubleshooting
Recurring Subscription option not showing:
- Verify that Stripe is configured as your preferred payment provider in payment settings.
Invalid Product or Price ID:
- Ensure the IDs are copied exactly from your Stripe dashboard.
- Verify that the Price is associated with the correct Product in Stripe.
- Check that the billing interval in Stripe matches your subscription settings.
Duration field is locked:
- This is expected behavior. When recurring payments are enabled, the duration is automatically calculated based on your interval settings (e.g., 1 month = P1M).