Stripe | Financial Infrastructure to Grow Your Revenue

Stripe | Financial Infrastructure to Grow Your Revenue

4466 articles

Products now require a type field, differentiating their use with order SKUs or subscriptions and plans


Breaking changes

Products now require a type field, differentiating their use with order SKUs or subscriptions and plans Breaking changes

What’s new

Products now have a required type: good for products used with orders SKUs, or service for products used with subscriptions and plans. On API versions older than 2018-02-05, type is set to good by default, and GET /v1/products omits products with type=service from the list. If you want to see products with type=service on API versions older than 2018-02-05, you can specify type=service when listing products.

Impact

This change introduces a required type attribute for products, distinguishing between physical goods and subscription services. You can now categorize your products more accurately.

Changes

ParameterChangeResources or endpoints
typeAddedProduct#create

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: 2018-02-05
  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?