Stripe | Financial Infrastructure to Grow Your Revenue

Stripe | Financial Infrastructure to Grow Your Revenue

4466 articles

Nested subscription schedule settings under default_settings


Breaking changes

Nested subscription schedule settings under default_settings Breaking changes

What’s new

On subscription schedules, invoice_settings, default_payment_method, billing_thresholds and collection_method are now nested under default_settings.

Impact

Lets you more easily manage the various settings associated with subscription schedules. By nesting the invoice_settings, default_payment_method, billing_thresholds, and collection_method properties under a new default_settings field, the subscription schedule API becomes more organized and intuitive.

Changes

ParametersChangeResources or endpoints
billing_thresholds collection_method days_until_due invoice_settingsChangedSubscriptionSchedule

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: 2019-11-05
  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?