What's new?
We've added the ability to update subscriptions that are scheduled to be paused or canceled, including adding or removing items and changing quantities.
There's no changes to endpoints or fields in the API as a result of this change — it's an update to the way the Paddle platform handles subscriptions with a scheduled pause or cancel.
How it works
When pausing or canceling subscriptions, you can set them to pause or cancel at the end of the billing period. When you do this, Paddle creates a scheduled change to say that the subscription should be paused or canceled on the next billing date.
Previously, you couldn't make changes to a subscription with a scheduled change to pause or cancel. Now, you can add or remove items or change quantities for subscriptions with a scheduled change. This lets customers add or remove addons or additional modules or upgrade or downgrade a plan so you can continue to realize revenue before a pause or cancellation goes through.
When making a change to a subscription with a scheduled change, you must use full_immediately, prorated_immediately, or do_not_bill as the proration_billing_mode. You can't bill changes on the next billing period.
Next steps
This change is available in version 1 of the Paddle API.
It's a non-breaking change, meaning it doesn't impact existing integrations.
You can use the preview a subscription and update a subscription operations in the API to update subscriptions with a scheduled change.
Summary of changes
| Entity | Field | Change | Type |
|---|---|---|---|
| Subscriptions | subscription_invalid_billing_mode_for_scheduled_change | + Added | Error |