Subscriptions

Overview

Subscriptions allow you to manage recurring billing, automate invoicing, and provide customers with access to your products or services based on their subscription level.

The typical flow for setting up subscriptions is:

1. Create products with their prices
2. Optionally, create plans to bundle products together
3. Create subscriptions for your customers using either a plan or individual product directly

Plans are not required to create subscriptions, but they are a recommended way to bundle products together. You can also create a subscription with products directly without a plan.

Create a subscription

To create a new subscription using the dashboard:

1. Navigate to Subscriptions → Create subscription
2. Select the customer account
3. Choose a plan, or add product directly
4. Configure the billing schedule and payment method
5. Click Create subscription to save

You can also create subscriptions programmatically using the Subscriptions API.

Proration

Proration is the process of adjusting the billing amount when a subscription is changed mid-cycle. For example, if a customer upgrades their plan halfway through the billing cycle, proration ensures they are only charged for the remaining time on the new plan.

Pricing models

Products can use different pricing models to suit your business needs:

• Flat pricing: A fixed amount charged at regular intervals (e.g., $20/month).
• Per-unit pricing: Charges based on the number of units consumed (e.g., $5 per user).
• Package pricing: Bundled pricing for a set of features or services (e.g., $50 for 100 API calls).
• Graduated pricing: Tiered pricing based on usage volume (e.g., $10 for the first 100 units, $8 for the next 100 units).
• Volume pricing: Similar to graduated pricing, but each tier is charged at its own rate (e.g., $10 for the first 100 units, $8 for the next 100 units, etc.).