Skip to main content

What are billing cycles?

Each plan can have multiple Billing Cycles — different intervals (monthly, quarterly, yearly) each with their own price. Customers choose a cycle when ordering.

Creating a cycle

Go to Admin → Plans → [Plan Name] → Cycles → Add Cycle.

Example cycle setup

How expiry works

When a customer orders, the service expiry date is calculated as:
If the customer renews before expiry, the new expiry is extended from the current expiry date (not from today), preventing gaps.

Stripe price objects

For plans using Stripe recurring billing, a StripePrice record is created and linked to each cycle. This maps the cycle to a Stripe Price ID for automatic renewal.

Free trials

Trial periods are configured on the plan level (not per cycle). If a plan has a 7-day trial, the customer gets 7 days free before the first billing cycle starts.