Subscriptions are now successfully created even if the first payment failsBreaking 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_ 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_.
Upgrade
- View your current API version in Workbench.
- 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
- If you don’t use an SDK, update your API requests to include
- Upgrade the API version used for webhook endpoints.
- Test your integration against the new version.
- If you use Connect, test your Connect integration.
Learn more about Stripe API upgrades.