Skip to content
Create account or Sign in
/
Ask AI
Create accountSign in
Get started
Payments
Revenue
Platforms and marketplaces
Money management
Developer resources
APIs & SDKsHelp
Basic usage-based billing
    Overview
    How basic usage-based billing works
    Compare basic usage-based billing and Metronome
    Migrate to Metronome
    Use cases
    Record usage for billing
      Create and configure a meter
      Record usage with the API
      Record usage in the Dashboard
      Record usage with S3
      Configure grace period
    Offer billing credits
    Monitor usage
    Manage usage-based billing setup
United States
English (United States)
  1. Home/
  2. Revenue/
  3. Basic usage-based billing

Record usage for billing

Learn how to record customer usage data.

Note

This page covers usage recording for basic usage-based billing with Billing Meters. Stripe recommends Metronome for new integrations. Metronome handles event ingestion, metering, and real-time usage visibility without custom recording infrastructure. Compare your options before building a new integration.

Legacy process

If you need guidance for the previous usage-based billing process, refer to our legacy documentation.

Throughout each billing period, you must record usage in Stripe to bill your customers the correct amounts. You can decide how often you record usage in Stripe. You can record usage in Stripe using the Dashboard or API.

To record usage in Stripe, first configure your meter and then add the recorded usage through the Stripe Dashboard or API.

Stripe processes meter events asynchronously, so aggregated usage in meter event summaries and on upcoming invoices might not immediately reflect recently received meter events.

Use the API

Use the Stripe API to record customer usage data.

Use the Stripe Dashboard

Use the Dashboard to upload a CSV file with usage data.

Use Amazon S3

Use Amazon S3 to add customer usage data in bulk.

Was this page helpful?
YesNo
  • Need help? Contact Support.
  • Chat with Stripe developers on Discord.
  • Check out our changelog.
  • Questions? Contact Sales.
  • LLM? Read llms.txt.
  • Powered by Markdoc
Related Guides
Usage-based pricing models