Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Revenue
Platforms and marketplaces
Money management
Developer tools
Overview
Billing
    Overview
    About the Billing APIs
    Subscriptions
    Invoicing
    Usage-based billing
      Choose a usage-based billing setup
        Use products and prices
        Use rate cards
          How rate cards work
          How rate card subscriptions work
          Manage rate card setup
      Record usage for billing
      Offer billing credits
      Monitor usage
      Usage-based pricing models
    Connect and Billing
    Tax and Billing
    Quotes
    Revenue recovery
    Automations
    Scripts
    Revenue recognition
    Customer management
    Entitlements
    Test your integration
Tax
Reporting
Data
Startup incorporation
HomeRevenueBillingUsage-based billingChoose a usage-based billing setupUse rate cards

How rate cards workPrivate preview

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

Copy page

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:

Example image of a rate card

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 itemA 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 rateA 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 subscriptionA 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.
Was this page helpful?
YesNo
Need help? Contact Support.
Join our early access program.
Check out our changelog.
Questions? Contact Sales.
LLM? Read llms.txt.
Powered by Markdoc