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 Subscriptions integrated.

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.