Stripe | Financial Infrastructure to Grow Your Revenue

Stripe | Financial Infrastructure to Grow Your Revenue

4466 articles

Invoices now specify their automatic collection behavior using the auto_advance field


Breaking changes

Invoices now specify their automatic collection behavior using the auto_advance field Breaking changes

What’s new

The closed property on the Invoice object controls automatic collection. Deprecates closed in favor of the more specific auto_advance field. Where you might have set closed=true on invoices in the past, set it to auto_advance=false.

Impact

Replacing the closed property with the new auto_advance field on Invoice objects to control automatic collection lets you have more specific control over the invoice lifecycle, allowing you to use auto_advance=false instead of closed=true to prevent automatic collection.

Changes

ParametersChangeResources or endpoints
closedRemovedInvoice#update
closedRemovedInvoice

Upgrade

  1. View your current API version in Workbench.
  2. If you use an SDK, upgrade to the corresponding SDK version for this API version.
  • If you don’t use an SDK, update your API requests to include Stripe-Version: 2018-11-08
  1. Upgrade the API version used for webhook endpoints .
  2. Test your integration against the new version.
  3. If you use Connect, test your Connect integration .
  4. In Workbench, perform the upgrade . You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.

Last verified 2026-09-24

Is this helpful?