- Breaking changes
- Public preview
Adds additional next action support for Shared Payment Tokens Breaking changes Public preview
What’s new
Adds the redirect_to_url next action type to the SharedPaymentToken object.
This change also adds the optional use_stripe_sdk boolean parameter to the Create a SharedPaymentToken endpoint, the SharedPaymentToken object, and the Confirm a requested Delegated Checkout Session endpoint.
Set use_stripe_sdk to true to indicate that you’re using Stripe.js, the iOS SDK, or the Android SDK to handle next actions on the client side.
If you set use_stripe_sdk to false, you must also provide a return_url, and the API returns a redirect_to_url next action for 3D Secure authentication flows.
Why is this a breaking change?
Previously, next_action.type on the SharedPaymentToken only returned use_stripe_sdk. Now, either use_stripe_sdk or redirect_to_url can be returned. If you have an integration that validates or switches on next_action.type and only handles use_stripe_sdk, you might need to update your logic to also handle the new redirect_to_url value.
Impact
If your integration uses Stripe.js, the iOS SDK, or the Android SDK to handle next actions, set use_stripe_sdk to true when creating a Shared Payment Token or confirming a requested Delegated Checkout Session. If you handle next actions outside of a Stripe client-side SDK, set use_stripe_sdk to false and include a return_url to redirect your customers back to your application after completing 3D Secure authentication.
Changes
| Parameters | Change | Resources or endpoints |
|---|---|---|
| use_stripe_sdk | Added | SharedPayment. IssuedToken SharedPayment. IssuedToken#create |
| redirect_to_url | Added | SharedPayment. IssuedToken. next_action |
| Field | Change | From → to |
| SharedPayment. IssuedToken. next_action. type | Changed | literal('use_stripe_sdk') → enum('redirect_to_url'|'use_stripe_sdk') |
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: 2026-07-29. preview
- 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.