Metered Items are the principle components of a product. Any product can have any number of metered items that are billed.
Each metered item will be tied to a specific billable metric and will be charged on that billable metric. For more details on how billable metrics work, check out our Billable Metrics page.
Each Metered Item will have these fields:
- Nickname The name to show on the invoice. If this isn't passed, this will default to the billable metric.
- billable_metric_id The id of the billable metric to be measured
- tier_mode The tiered mode. Details are below.
- tiers The list of tiers for this billable metric. This is where you allocate how usage is tracked and charged.
You can set two different tier modes for the billable metric.
|Volume||As usage increases, and certain tiers are hit, the overall usage gets priced as an average of the last tier.|
|Graduated||Graduated pricing charges for the usage in each tier instead of applying a single price to all usage|
|Sum||The default value (passed if you don’t specify the parameter). The total billed is based on the sum of all usage records for the billing period.|
|last_during_period||The total billed is based on the most recent usage record for the billing period. If no usage is reported for the billing period, the total billed is based on a usage quantity of 0.|
|last_ever||The total billed is based on the most recently provided usage record. If no usage is reported during the current billing period, Stripe looks for a previous usage record. If no usage record is found, the total billed is based on a usage quantity of 0.|
|max||The total billed is based on the usage record with the largest usage quantity for the billing period. If no usage is reported for the billing period, the total billed is based on a usage quantity of 0.|
Updated about 1 year ago