Change plan
Change the subscription plan by replacing the current product offering with a new one.
This flow supports upgrades, downgrades, and switching between product types (for example, voice to data-only).
This flow covers the full lifecycle of a plan change, from order creation to product replacement.
Best for: Use this flow when you want to modify an existing subscription plan without canceling and recreating the subscription.
What you will do
Follow the exact partner journey to replace a product offering.
The change can be applied immediately, at the end of the billing cycle, or at a specific date.
Plan lifecycle
Change plan, step by step
Follow the lifecycle used to upgrade, downgrade, or switch between product types such as MT and data-only plans.
Identify the active subscription that will be updated and select the new product offering that will replace the current plan.
Create a change_subscription_plan order type using schedule mode immediate. The current product is replaced right away by the new product offering.
Create a change_subscription_plan order type using schedule mode end_of_cycle. The current plan stays active until the billing cycle boundary, then the new plan starts.
Create a change_subscription_plan order type using schedule mode specific_date and provide effective_at. The change is executed at the exact timestamp defined.
Once the change is executed, the old product is canceled, the new one becomes active, and the subscription continues with the updated plan.