Adds scheduled subscription downgrades in the customer portal
What’s new
You can now configure the customer portal so that subscription downgrades occur at the end of the billing cycle, rather than immediately.
You can manage downgrades in the Dashboard or by using the schedule_at_period_end when you create a portal configuration through the API.
Impact
Previously, customers on higher cost plans that allocated credits that switched to a lower cost plans would be given access to the remaining credits on the higher cost plan. This change makes it possible for downgrades to occur at the end of a billing cycle, preventing the credit issue.
Changes
| Parameter | Change | Resources or endpoints |
|---|---|---|
| schedule_at_period_end | Added | BillingPortal. Configuration#create. features. subscription_update BillingPortal. Configuration#update. features. subscription_update BillingPortal. Configuration. features. subscription_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: 2024-10-28. acacia
- 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.