How rate cards workPrivate preview

Learn how you can use rate cards to model your business on Stripe.

You can use rate cards to offer complex pay-as-you-go pricing models. You subscribe customers to one rate card that contains many different rates. You can add new rates to rate cards so that existing customers can use new features and get billed for their usage immediately. You can also create different versions of rate cards. Learn how to set up usage-based billing with rate cards.

Private preview

Rate cards are currently in private preview and could change in functionality and integration path before they’re generally available to all Stripe users. Contact here to request access.

Example rate card

Here’s an example of what a complete card looks like:

A rate card with a rate that contains a metered item.

Rate card concepts

Here are the key concepts for understanding how rate cards work.



Meter	Meters specify how to aggregate meter events over a service interval. Meter events represent all actions that customers take in your system (for example, API requests). Meters attach to metered items and form the basis of what’s billed. For example, a business offering AI services might have meter events that represent the number of tokens a customer uses in a query. The meter tracks the sum of tokens over a month. The aggregated usage forms the basis for the invoices generated for each billing cadence. You can use the Stripe Dashboard or API to configure a meter.
Metered item	A metered item is the granular item that the customer is paying for. For example, an LLM model or tier of token usage. You can apply metered items to multiple rate card rates. Each metered item must be associated with a meter.
Rate card	A rate card is a collection of rates, representing a comprehensive pricing plan for a product. You can subscribe customers to a rate card by creating a rate card subscription that’s associated with a billing cadence. You can subscribe multiple customers to a rate card. You can also subscribe customers to specific rate card versions.
Rate card rate	A rate card rate is the pricing configuration for a metered item in a rate card. The rate defines the price type (fixed rate, volume, graduated, or overage), price amount, and quantity configuration (you can sell individual units or packages of units). Each rate card can contain multiple rates (up to 1,000).
Rate card subscription	A rate card subscription is the customer subscription associated with a rate card. You can associate multiple subscriptions with one billing cadence. This means that you can subscribe a customer to multiple rate cards with different service intervals but the customer is only charged according to one billing cadence. Learn more about how rate card subscriptions work.
Rate card version	A rate card version is a versioned snapshot of a rate card. When you create a rate card, an initial live version is set as the default for new subscribers. Modifying or deleting existing rates creates a new version; adding new rates doesn’t create a new version. When subscribing customers, you can specify a version or let Stripe assign the current live version. Customers stay on their assigned version unless manually changed, which lets you set different pricing for new and existing customers.