Tiered pricing is a model where fees vary between usage levels.
Metering & Billing supports two types of tiered pricing:
Graduated pricing is a model where you charge each unit according to the tier it falls into.
For example:
|
First Unit
|
Last Unit
|
Unit Price
|
Flat Price
|
|
0
|
1000
|
$0.3
|
$0
|
|
1001
|
5000
|
$0.2
|
$0
|
|
5001
|
∞
|
$0.1
|
$0
|
In this example, a customer with 6,000 units would be charged as:
(1000 × $0.3) + (4000 × $0.2) + (1000 × $0.1) = $300 + $800 + $100 = $1,200
The following table breaks down the options for configuring a graduated pricing model:
|
Parameter
|
Description
|
|
Billing cadence
|
Select the interval at which customers are billed for their usage, such as monthly or yearly.
|
|
Price mode
|
Set to Graduated.
The price of each unit is determined by the tier it falls into.
|
|
Tiers
|
Define pricing tiers by setting the first unit, last unit, unit price in the plan’s configured currency, and an optional flat fee per tier.
|
|
Usage discount
|
Number of free units included before billing starts.
|
|
Percentage discount
|
Reduces price by a fixed percent across all usage.
|
|
Minimum commitment
|
The minimum amount the customer is charged per billing period, regardless of usage.
|
|
Maximum commitment
|
The maximum amount the customer is charged per billing period, regardless of usage.
|
|
Tax behavior
|
Select from one of the following behaviors:
- Inclusive: The listed price already includes tax.
- Exclusive: The tax is added on top of the listed price.
See Tax calculations for details.
|
|
Stripe Tax Code
|
Select a tax code. For Stripe, see the Stripe Tax Code reference for available values.
|
Volume pricing is a model where you charge customers based on the highest achieved tier.
For example:
|
First Unit
|
Last Unit
|
Unit Price
|
Flat Price
|
|
0
|
1000
|
$0.3
|
$0
|
|
1001
|
5000
|
$0.2
|
$0
|
|
5001
|
∞
|
$0.1
|
$0
|
Based on this table, a customer with 6,000 units would reach the unit price tier of $0.1, so they would be charged:
The following table breaks down the options for configuring a volume pricing model:
|
Parameter
|
Description
|
|
Billing cadence
|
Select the interval at which customers are billed for their usage, such as monthly or yearly.
|
|
Price mode
|
Set to Volume. The price of all units is determined by the highest tier reached.
|
|
Tiers
|
Define pricing tiers by setting the first unit, last unit, unit price in the plan’s configured currency, and an optional flat fee per tier.
|
|
Usage discount
|
Number of free units included before billing starts.
|
|
Percentage discount
|
Reduces price by a fixed percent across all usage.
|
|
Minimum commitment
|
The minimum amount the customer is charged per billing period, regardless of usage.
|
|
Maximum commitment
|
The maximum amount the customer is charged per billing period, regardless of usage.
|
|
Tax behavior
|
Select from one of the following behaviors:
- Inclusive: The listed price already includes tax.
- Exclusive: The tax is added on top of the listed price.
See Tax calculations for details.
|
|
Stripe Tax Code
|
Select a tax code. For Stripe, see the Stripe Tax Code reference for available values.
|
With tiered pricing, you can define flat fees for each tier in addition to unit pricing.
For example, you could charge $500 for the first tier and $0.1 per unit for the rest.
This is useful to define overage charges or to bill a flat fee regardless of usage.
For example:
|
First Unit
|
Last Unit
|
Unit Price
|
Flat Price
|
|
0
|
1000
|
$0
|
$500
|
|
1001
|
∞
|
$0.1
|
$0
|
Based on this table, a customer that uses 2,000 units would be charged as:
(1000 * $0 + $500) + (1000 * $0.1 + $0) = $500 + $100 = $600
Tiers start from 0, so defining a flat fee in the first tier will always cause the customer to be billed, regardless of usage.
For example, if you have a flat fee of $500 in the first tier, the total amount will be $500 when the quantity is 0.
To bill $0 when there’s no usage, set the unit price for the first tier and omit the flat price. Let’s use the previous example, but this time set a $500 flat fee for the first tier and $0.1 per unit for the rest:
|
First Unit
|
Last Unit
|
Unit Price
|
Flat Price
|
|
0
|
1
|
$500
|
$0
|
|
2
|
1000
|
$0
|
$0
|
|
1001
|
∞
|
$0.1
|
$0
|
In this example, if a customer uses 2,000 units, they will be charged as:
(1 * $500 + $0) + (999 * $0 + $0) + (1000 * $0.1 + $0) = $500 + $0 + $100 = $600
But if this customer uses 0 units, they will be charged as:
(0 * $500 + $0) + (0 * $0 + $0) + (0 * $0.1 + $0) = $0 + $0 + $0 = $0