Tiered subscriptions in self-service checkout

Your customers can now sign up for a tiered subscription directly from self-service checkout - just like flat-rate, license-based and usage-based plans.

How it works

The customer is automatically placed on the lowest tier at signup. There is no tier picker in checkout - instead the customer is moved to a higher tier later, automatically, once their usage crosses the limits you have configured.

On the checkout page the customer can see which tier they are starting on, plus an overview of all tiers and prices, so they know what it costs as they grow.

Pre-seed via the API

If you create a checkout session through the API and already know what the customer’s usage is (e.g. seats or API calls), you can pass a usage_parameters object in metadata. The customer then lands directly on the correct tier from day 1 instead of starting on the lowest and being upgraded shortly after.

Example:

"metadata": {
  "usage_parameters": {
    "seats": 25,
    "api_calls": 10000
  }
}

See the full documentation under /checkout-sessions in the API reference.