Stripe | Financial Infrastructure to Grow Your Revenue

Stripe | Financial Infrastructure to Grow Your Revenue

4466 articles

Removes the display_items property from Checkout Sessions


Breaking changes

Removes the display_items property from Checkout Sessions Breaking changes

What’s new

Checkout Sessions no longer include the display_items property. Use the includable line_items property instead.

Impact

Lets you access the line item details for a Checkout Session using the line_items property, instead of the now-removed display_items property. This simplifies the Checkout Session response by consolidating the line item information into a single, consistent property.

Changes

ChangeResources
RemovedCheckout.Session.Checkout CompatibilityChangeRemoveCheckoutSessionDisplayItemsDisplayItem
ParameterChangeResources or endpoints
display_itemsRemovedCheckout. Session

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: 2020-08-27
  1. Upgrade the API version used for webhook endpoints .
  2. Test your integration against the new version.
  3. If you use Connect, test your Connect integration .
  4. In Workbench, perform the upgrade . You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.

Last verified 2026-09-24

Is this helpful?