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
    Overview
    How Invoicing works
    API quickstart
    Integrate with the API
    Invoicing without code
    Invoice lifecycle
    Preview invoices
    Edit invoices
    Schedule invoice finalization
    Status transitions and finalization
    Send customer emails
    Generate credit notes
    Invoice customers
    Customers
    Customer credit balance
    Customer tax IDs
    Invoice payments
    Hosted Invoice Page
    Create invoice payment plans
    Accept partial payments
    Payment application
    Payment methods for invoices
    Automated collections
    Invoice customization
    Customize invoices
    Invoice rendering templates
    Group invoice line items
    Summarize line items
    Global invoicing
    Best practices
    Multi-currency customers
    Other invoicing features
    Products and prices
    Manage bulk invoice line items
    Taxes
Usage-based billing
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
Overview
Business and product data use cases
SchemaData freshness
Sigma
Data Pipeline
Import external data
HomeRevenueInvoicing

Schedule invoice finalization to send or charge an invoice in the future

Learn how to schedule an invoice and automatically send or charge for it on a future date.

You can create an invoice on Stripe today and finalize or charge for it on a future date.

Caution

When you use a custom finalization time for invoices, finalization won’t be delayed because of invoice.created webhook failures. This is different from the behavior described in the Webhooks and invoices guidance.

Before you begin

To configure an automatic finalization time for an invoice, you must have automatic invoice advancement enabled for the invoice. Dashboard scheduled invoices have this enabled automatically. You can automatically finalize an invoice up to 5 years in the future. If you don’t pass in a value for automatically_finalizes_at when enabling automatic invoice advancement in the API, Stripe calculates and sets the time according to the configurable grace period you currently have set. Turning off automatic advancement disables the invoice from being automatically charged or sent. Learn more about this in Pause invoice advancement.

Schedule a one-off invoice to finalize in the future

For a draft invoice that you want to send for payment, you can specify a date in the future to either finalize the invoice or finalize and send it.

  1. After you complete your invoice details, click Review. You’ll see an option to Finalize and send or Finalize only.

  2. If you’re sending the invoice to your buyer, you can toggle Schedule send date and pick a date in the future. If you only need to finalize the invoice without sending it automatically, you can toggle Schedule finalization date. After making your selection, click Schedule invoice.

  3. Your invoice is now scheduled, and you can can edit the draft or cancel it. Click Edit draft to edit it, or click Unschedule to cancel the scheduled finalization.

For invoices where you charge the buyer automatically, the option to Schedule charge date is in the invoice editor.

Viewing scheduled invoices

You can view scheduled invoices in the Dashboard in a few ways:

  • Filter invoices for whether or not they have scheduled invoice finalization enabled, based on the Finalization date column and Finalization date filter on the Invoices page.

  • In the Details section of a page for a specific invoice, the Finalizes at property indicates when that invoice is scheduled to be finalized.

Subscription invoice usage

Invoices generated by subscriptions are already scheduled for finalization upon invoice creation, based on the configurable grace period you currently have set. Turning off automatic advancement disables the invoice from being automatically charged or sent to the user. Learn how to pause invoice advancement for any you have set. You can modify these invoices using the process described here, but make sure you consider the following:

  • Non-finalized invoices remain in a draft state. This means that pushing this scheduled finalization date out further potentially increases the time that customers could have an active subscription without having an invoice be sent or charged to them.
  • Modifying this time won’t cause invoice finalization to be delayed based on failure to respond to invoice.created webhooks. If you want to depend on webhook failures delaying invoice finalization, don’t modify this automatically_finalizes_at field.

Common pitfalls

This feature has some common pitfalls to be aware of:

  • If the invoice has automatic_tax[enabled]=true but the customer doesn’t have sufficient tax information, automatic finalization fails. Learn more about invoice finalization errors and how to resolve this issue.
  • The Send finalized invoices and credit notes to customers setting must be enabled in Subscriptions and emails settings if you want emails for automatically finalized invoices to send to customers.
    • This ability of sending emails for automatically finalized invoices is only available in live mode.
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