Plans Overview

A Plan is the core billing product in Fluxrate. It packages together:

Features — what capabilities the plan unlocks
Charges — how much and how the customer is billed

Customers subscribe to plans, and Fluxrate automatically manages the billing cycle.

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

curl -X POST https://api.fluxrate.co/api/v1/plans \
  -H "Content-Type: application/json" \
  -H "Cookie: access_token=<token>" \
  -d '{
    "name": "Pro",
    "lookup_id": "pro",
    "description": "For growing teams",
    "type": "HYBRID",
    "billing_interval": "month",
    "currency": "USD",
    "trial_days": 14
  }'

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

Plan Lifecycle

Active → Deactivated (no new subscriptions)

A plan cannot be deleted if it has active subscriptions. You must first cancel or migrate all subscriptions before deleting.

Once a plan has active subscriptions, changes to pricing may affect existing customers. Consider creating a new plan version instead.

Plan Structure Example

Here’s how a complete “Pro” plan might look:

Pro Plan ($49/month + usage)
├── Features
│   ├── API Calls (meter) → 50,000 calls/month limit
│   ├── Analytics Dashboard (switch) → enabled
│   └── Max Team Members (custom) → "10"
└── Charges
    ├── Base Fee → $49/month (FIXED)
    └── API Call Charge → $0.001/call (USAGE, linked to api_calls meter)

Get Started

Product Guide

Developer Guides

Plan Types

Fixed

Usage-based

Hybrid

Creating a Plan

Plan Fields

Billing Intervals

Plan Lifecycle

Plan Structure Example

​Plan Types

Fixed

Usage-based

Hybrid

​Creating a Plan

​Plan Fields

​Billing Intervals

​Plan Lifecycle

​Plan Structure Example

Plan Types

Creating a Plan

Plan Fields

Billing Intervals

Plan Lifecycle

Plan Structure Example