Breaking changes
Plans now link to individual products, with several fields moving to the product resource Breaking changes
What’s new
Each Plan object is now linked to a Product object with type=service. This change moves the Plan object statement_descriptor and name attributes to Product objects. Additionally, Plan objects now have a nickname attribute. Creating a plan now requires passing a product attribute to POST /v1/plans. This can be either an existing product ID or a dictionary of product fields, so that you can continue to create plans without separately creating products.
Impact
This change introduces a new relationship between Plan and Product objects, moving certain attributes to the Product object and adding a nickname to plans. You now need to specify a product when creating plans, either by referencing an existing product or providing product details. This modification enhances the flexibility and organisation of subscription-related data, but requires updates to plan creation processes.
Changes
| Parameters | Change | Resources or endpoints |
|---|---|---|
| name statement_descriptor | Removed | Plan Plan#create Plan#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: 2018-02-05
- 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.