- Features — what capabilities the plan unlocks
- Charges — how much and how the customer is billed
Plan Types
Fixed
Flat recurring fee. Simple and predictable. Great for SaaS subscriptions.
Usage-based
Charge based on consumption. Pay-as-you-go. Great for APIs and infrastructure.
Hybrid
Base fee + usage charges. Best of both worlds for modern SaaS.
Creating a Plan
- Dashboard
- API
- Navigate to Plans in the sidebar
- Click Create Plan
- Choose the plan type, billing interval, and currency
- Add charges and features
- Save the plan
Plan Fields
| Field | Required | Description |
|---|---|---|
name | ✅ | Display name for the plan |
lookup_id | ✅ | Unique slug identifier within your org |
type | ✅ | FIXED, USAGE, or HYBRID |
billing_interval | ✅ | day, week, month, or year |
currency | ✅ | ISO 4217 currency code (e.g., USD, EUR, INR) |
trial_days | Length of free trial period in days | |
description | Human-readable plan description | |
is_active | Whether the plan is available for new subscriptions |
Billing Intervals
Plans support four billing cadences:| Interval | Description |
|---|---|
day | Billed daily |
week | Billed weekly |
month | Billed monthly (most common) |
year | Billed annually |