> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluxrate.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Hybrid Pricing

> Combine a fixed base fee with usage-based charges for the most flexible pricing model.

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 + $0.001/API call
* $99/month with 100,000 API calls included, then $0.0005 per additional call
* $199/month + $5/active seat/month

## Creating a Hybrid Plan

```bash theme={null}
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:

```bash theme={null}
# 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:

```bash theme={null}
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"
  }'
```

<Warning>
  A charge can only be deactivated, not reactivated. Create a new charge if you need to re-enable it.
</Warning>