Breaking changes

A subscription's ending period can no longer be configured while canceling it Breaking changes

What’s new

Going forward, the DELETE endpoint is reserved for immediate cancelling. You can no longer set at_period_end in the subscription DELETE endpoints. Use cancel_at_period_end on the subscription update endpoints instead.

Impact

Deleting a subscription cancels it immediately. To cancel it at the end of the period, update the subscription with cancel_at_period_end set to true.

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-08-23

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.