Checkout Session allows shipping option updates
What’s new
Adds support for updating shipping_options on existing Checkout Sessions.
Impact
You can now update the shipping_options parameter on a Checkout Session after creation. This gives you more control over shipping options available to customers during checkout. For implementation examples, see Dynamically customize shipping options.
Changes
| Parameter | Change | Resources or endpoints |
|---|---|---|
| shipping_options | Added | Checkout.Session#update |
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: 2025-03-31. basil
- 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.