Adds optional items to Checkout Sessions and Payment Links
What’s new
Adds support to Checkout and Payment Links for offering optional items that customers can add to their orders during checkout.
Impact
The optional items feature lets you offer complementary products to your customers during checkout. You can configure these items using the optional_items parameter in the Checkout Sessions and Payment Links APIs.
Changes
| Parameter | Change | Resources or endpoints |
|---|---|---|
| optional_items | Added | Checkout. Session#create Checkout. Session PaymentLink#create + 1 more PaymentLink |
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.