Breaking changes
Enables automatic payment methods by default for PaymentIntents and SetupIntentsBreaking changes
What’s new
PaymentIntents and SetupIntents now have dynamic automatic_ enabled by default, which allows you to configure payment method settings from the Dashboard. The previous default was to accept only card payments when both payment_ and automatic_ weren’t specified. For more information, see the upgrade guide.
- When confirming a PaymentIntent, you’re now required to provide a
return_, unlessurl off_.session=true - When confirming a PaymentIntent, you can’t use
error_. Useon_ requires_ action payment_withmethod_ types error_if you want to fail payment attempts when PaymentIntents transition intoon_ requires_ action requires_.action - When confirming a SetupIntent, you’re now required to provide a
return_.url - You can bypass the
return_requirement usingurl automatic_, this will automatically filter payment methods that require redirect even if they’re enabled in the Dashboard.payment_ methods[allow_ redirects]=never
Impact
PaymentIntents and SetupIntents now use automatic dynamic payment methods by default, allowing for configuration through the Stripe Dashboard.
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: 2023-08-16
- 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.
- In Workbench, perform the upgrade. You can roll back the version for 72 hours.
Learn more about Stripe API upgrades.