Breaking changes

Enables automatic payment methods by default for PaymentIntents and SetupIntents Breaking changes

What’s new

PaymentIntents and SetupIntents now have dynamic automatic_payment_methods 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_method_types and automatic_payment_methods weren’t specified. For more information, see the upgrade guide.

• When confirming a PaymentIntent, you’re now required to provide a return _ url , unless off _ session=true .
• When confirming a PaymentIntent, you can’t use error _ on _ requires _ action . Use payment _ method _ types with error _ on _ requires _ action if you want to fail payment attempts when PaymentIntents transition into requires _ action .
• When confirming a SetupIntent, you’re now required to provide a return _ url .
• You can bypass the return _ url requirement using automatic _ payment _ methods[allow _ redirects]=never , this will automatically filter payment methods that require redirect even if they’re enabled in the Dashboard.

Impact

PaymentIntents and SetupIntents now use automatic dynamic payment methods by default, allowing for configuration through the Stripe Dashboard.

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: 2023-08-16

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.