Skip to main content
Hybrid pricing combines a flat recurring fee with metered usage charges. This is the most common model for modern SaaS products that want baseline revenue plus upside from high-usage customers.

When to Use Hybrid Pricing

  • You provide a baseline product value (warrants a base fee) AND usage-dependent value
  • You want predictable minimum revenue per customer
  • You want to charge for heavy usage without increasing the base fee for light users
Examples:
  • 49/month+49/month + 0.001/API call
  • 99/monthwith100,000APIcallsincluded,then99/month with 100,000 API calls included, then 0.0005 per additional call
  • 199/month+199/month + 5/active seat/month

Creating a Hybrid Plan

curl -X POST https://api.fluxrate.co/api/v1/plans \
  -H "Content-Type: application/json" \
  -H "Cookie: access_token=<token>" \
  -d '{
    "name": "Growth",
    "lookup_id": "growth",
    "type": "HYBRID",
    "billing_interval": "month",
    "currency": "USD"
  }'

Adding Both Charges

Add a fixed charge AND a usage charge to the same plan:
# Fixed base fee
curl -X POST https://api.fluxrate.co/api/v1/plans/<plan_id>/charges \
  -H "Content-Type: application/json" \
  -H "Cookie: access_token=<token>" \
  -d '{
    "type": "FIXED",
    "unit_price": 49.00,
    "display_name": "Base subscription"
  }'

# Usage charge
curl -X POST https://api.fluxrate.co/api/v1/plans/<plan_id>/charges \
  -H "Content-Type: application/json" \
  -H "Cookie: access_token=<token>" \
  -d '{
    "type": "USAGE",
    "meter_id": "<api_calls_meter_id>",
    "unit_price": 0.001,
    "display_name": "API calls"
  }'

Example: Growth Plan

Growth Plan ($49/month + usage)
├── Features
│   ├── API Calls (meter) → unlimited (billed per use)
│   ├── Analytics Dashboard (switch) → enabled
│   └── Max Team Members (custom) → "25"
└── Charges
    ├── Base Fee → $49.00/month
    └── API Calls → $0.001/call

Example Invoice

Invoice: INV-2025-0055
Period: Feb 1 – Feb 28, 2025

Line Items:
  Base subscription (Feb 1 – Feb 28)          $49.00
  API Calls (145,200 calls × $0.001)         $145.20
  ─────────────────────────────────────────────────
  Subtotal                                   $194.20
  Tax (18% GST)                               $34.96
  Total                                      $229.16

Deactivating a Charge

If you want to temporarily stop billing for a specific charge without deleting the plan:
curl -X PATCH https://api.fluxrate.co/api/v1/plans/<plan_id>/charges/<charge_id> \
  -H "Content-Type: application/json" \
  -H "Cookie: access_token=<token>" \
  -d '{
    "status": "INACTIVE"
  }'
A charge can only be deactivated, not reactivated. Create a new charge if you need to re-enable it.