Seat-Based Billing

Seat-based billing lets you charge customers based on the number of active users in their workspace. Crovver handles proration on seat upgrades automatically.

1. Create a Seat-Based Plan

In the dashboard or via API:

{
  "name": "Business",
  "is_seat_based": true,
  "base_price": 5000,         // $50 base price
  "included_seats": 10,       // Covers 10 seats
  "per_seat_price": 500,      // $5 per additional seat
  "min_seats": 5,
  "max_seats": 500,
  "billing_interval": "monthly"
}

Pricing examples:

8 seats → $50 (within included seats)
15 seats → $50 + (5 ×$ 5) = $75
25 seats → $50 + (15 ×$ 5) = $125

2. Checkout with Seat Count

Pass totalCapacityUnits when creating the checkout session:

POST /api/public/checkout
Authorization: Bearer sk_live_...

{
  "requestingTenantId": "workspace_123",
  "planId": "plan_business",
  "provider": "stripe",
  "totalCapacityUnits": 20,
  "successUrl": "https://app.com/welcome",
  "cancelUrl": "https://app.com/pricing"
}

3. Upgrade Seat Count with Proration

When a workspace needs more seats mid-billing cycle:

POST /api/public/capacity/proration-checkout
Authorization: Bearer sk_live_...

{
  "requestingTenantId": "workspace_123",
  "newCapacity": 30,
  "successUrl": "https://app.com/settings?upgraded=1",
  "cancelUrl": "https://app.com/settings/seats"
}

Crovver calculates the prorated charge for the remaining days in the billing period and returns a Stripe checkout URL. After payment, the subscription’s capacityUnits updates automatically.

Overview

Core Concepts

Authentication

SDKs

Guides

Seat-Based Billing

1. Create a Seat-Based Plan

2. Checkout with Seat Count

3. Upgrade Seat Count with Proration

​1. Create a Seat-Based Plan

​2. Checkout with Seat Count

​3. Upgrade Seat Count with Proration

1. Create a Seat-Based Plan

2. Checkout with Seat Count

3. Upgrade Seat Count with Proration