Breaking changes

Subscriptions are now successfully created even if the first payment fails Breaking changes

What’s new

Creating a subscription succeeds even when the first payment fails. The subscription is created in an incomplete status, where it remains for up to 23 hours. During that time period, it can be moved into an active state by paying the first invoice. If no successful payment is made, the subscription moves into a final incomplete_expired state. Updates to a non-incomplete subscription that require a payment also succeed regardless of the payment status. Before tjhis version, all creations or updates would fail if the corresponding payment failed. For more details, see our guide on the subscription lifecycle.

Impact

This change allows you to create subscriptions even when the initial payment fails, introducing an incomplete status that lasts up to 23 hours. This gives your users a grace period to resolve payment issues before a subscription becomes incomplete_expired.

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-03-14

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 .
6. In Workbench, perform the upgrade . You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.