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 resources
Overview
Billing
OverviewAbout the Billing APIs
Subscriptions
Invoicing
Usage-based billing
    Overview
    Choose a usage-based billing setup
    Record usage for billing
      Create a meter
      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
Quotes
Customer management
Billing with other products
Revenue recovery
Automations
Test your integration
Tax
Overview
Use Stripe tax
Manage compliance
Reporting
Overview
Select a report
Configure reports
Reports API
Reports for multiple accounts
Revenue recognition
Data
OverviewSchema
Custom reports
Data Pipeline
Data management
HomeRevenueUsage-based billing

Record usage for billing

Learn how to record customer usage data.

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.

Using the API

Use the Stripe API to record customer usage data.

Using the Stripe Dashboard

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

Using Amazon S3

Use Amazon S3 to add customer usage data in bulk.

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
Related Guides
Usage-based pricing models
Products Used
Billing