Breaking changes

Updating a cancelled subscription on a future date no longer resets its status Breaking changes

What’s new

Updating a subscription set to cancel on a future date no longer clears the cancellation status. To clear the cancellation status, specify cancel_at_period_end=false when updating a subscription.

Impact

This change maintains the future cancellation status of a subscription when it’s updated, unless explicitly cleared. You must now specify cancel_at_period_end=false to remove a planned cancellation when updating a subscription. This modification provides more control over subscription cancellation management, but might require updates to existing code that assumes updating a subscription automatically clears its cancellation status.

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-02-28

3. Upgrade the API version used for webhook endpoints .
4. Test your integration against the new version.
5. If you use Connect, test your Connect integration .

Learn more about Stripe API upgrades.