Breaking changes
Promotion Codes now reference Coupons using a polymorphic field for promotions Breaking changes
What’s new
Moves the top-level coupon field on Promotion Codes to promotion.coupon, as part of a new promotion hash which is polymorphic.
Why is this a breaking change?
You should now reference Coupons from Promotion Codes using the new promotion.coupon parameter, and specify the promotion.type parameter as coupon.
When you retrieve Promotion Codes, they don’t auto-expand the promotion.coupon field.
Impact
As we expand the list of supported promotion code types, you’ll be able to reference specific types when identifying Promotion Codes.
Changes
| Parameters | Change | Resources or endpoints |
|---|---|---|
| promotion | Added | PromotionCode PromotionCode#create |
| coupon | Removed | PromotionCode PromotionCode#create |
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-09-30. clover
- 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.
Related changes
- Removes iterations parameter for subscription schedules
- Adds the Discount source property and removes the Discount coupon property
- Makes flexible billing mode the default for new subscriptions
- Updates computation of subscription schedule phase end date to consider billing cycle anchor changes
- Adds customer portal configuration trial behavior
- Adds the ability to itemize proration discount amounts