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 billingRecord usage for billing

Configure an invoice finalization grace period

Learn how to configure a grace period for finalizing your invoices.

During the configured finalization grace period, you can continue to report usage for the previous billing period. When the invoice finalizes, Stripe updates it to reflect the latest quantity for its billing period. Use this setting if you need to record late arriving usage data in a previous billing cycle, or you need more time to record usage for a billing period that already ended.

Configure how long it takes for invoices enabled for automatic collection to transition from draft to finalized. You can set a delay of up to 72 hours (3 days). Don’t specify a value that’s longer than your subscription period. For example, if your subscription period is daily, don’t set a grace period greater than or equal to 24 hours.

Regional considerations

Invoice finalization requirements vary by region. Consult your legal advisor for advice specific to your business.

Configure the default grace period

  1. Go to the Invoice settings page.
  2. Under Invoice finalization grace period, review the configured finalization behavior. The default is set to 1 hour for all invoices.
  3. To change the default behavior for all invoices, do the following:
    • Click the overflow menu () in the Account default row, and select Edit.
    • Under Invoice finalization delay, specify the duration between invoice creation and finalization
    • Click Save.

Configure rules for the grace period

Rules allow you to set the grace period for specific groups of invoices. If the conditions on your rules aren’t met, Stripe uses the default behavior.

You can change the order that we apply rules by clicking Change order. You can’t change the order of the default behavior, which is always applied last. You can revert to the Stripe default behavior by deleting all other rules and setting the Invoice finalization delay to 1 hour.

For invoices with multiple products that might satisfy more than one rule, Stripe applies the more conservative grace period. For example, if an invoice includes one line item for a usage-based product (72 hours) and a simple subscription product (1 hour), the invoice finalizes after 72 hours.

The first invoice generated by a subscription set to charge automatically finalizes immediately, regardless of the rules you configure.

  1. On the Invoice settings page, under Invoice finalization grace period, click Add rule.
  2. On the Create new rule page, under Invoice finalization delay, specify the duration between invoice creation and finalization.
  3. Under Conditions, do the following to set the grace period:
    For invoicesDo the following
    Generated at the end of a subscription periodSelect Invoice is from a subscription cycle from the dropdown.
    With usage-based productsSelect Has a metered price from the dropdown.
    With usage-based products from a subscription cycleSelect Has a metered price from the dropdown. Click Add more conditions, then select Invoice is from a subscription cycle from the dropdown.
  4. Click Save.

Add usage to draft invoices

By default, newly recorded usage appears on an invoice when it’s finalized, and not on the draft invoice. You can delay finalization if you need more time to aggregate and add usage to your draft invoices. To add usage to existing invoices, they must meet the following conditions:

  • The invoice is in a draft state.
  • The timestamp from the meters request is within the subscription period for the invoice.

If the usage timestamp is for any time after the creation time of the draft invoice, we append the usage to the next invoice.

You can verify added usage on the Meters page in the Dashboard or using the Meters API.

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