Changing the Subscription Plan

How It Works

You can change a subscription plan by passing plan parameters in a token. The new plan will be activated starting from the next period.

Who Can Use It

Partners who have Store integrated and the Subscriptions module enabled.

How to Get It

In the request body, pass:

  • the ‘change_plan’ value in the purchase.subscription.operation parameter;
  • new plan ID in the purchase.subscription.plan_id parameter.

Note: If you use products, it is also necessary to pass the product ID in the purchase.subscription.product_id parameter.

You cannot change the plan if:

  • the currency of the new plan is different from the one of the existing plan;
  • the user already has an active subscription with this plan;
  • the subscription is not in the Active status;
  • the subscription period is trial.