Swapping Subscription Plans

Regarding this comment from a different thread, I don’t see an option to switch plans with subscription_plan_id field. Doesn’t seem to exist on the UpdateSubscription endpoint. From the same thread it’s also mentioned that we can only swap plan variations of the same parent plan. The comment above contradicts that, was hoping for some clarification.

Here is my scenario:
Someone is subscribed to a Yearly Plan for $50, and then wins contest and gets awarded a free membership for 1 year, I want to swap their current plan to the a free plan.

Initially thoughts is to have 2 SubscriptionPlan’s
Plan 1 - 1 phase with cadence of YEARLY - price $50
Plan 2 - 2 phases with cadence of YEARLY, phase 1 == price $0, phase 2 == price $50

Then have a current subscribed member switch from Plan 1 to Plan 2, which will take effect after Plan 1 billing cycle is completed.

The Swap Plan endpoint doesn’t seem to support plan swaps, instead it expects variation swap, and like i’ve read, this requires the same parent plan.

This 1 plan and multiple variations seems possible, but imagine if 1 person wins the contest multiple times and gets N number of 1 year free memberships, does this mean we need to create a bunch of extra variations like Plan 2 to account for that?

Any advice and help is much appreciated, thank you!

Hello @jsoa ,
You’re correct—Swap Plan typically supports variation swaps within the same parent plan. For your use case, a workaround is to create a single plan with multiple $0 variations (e.g. Free Year 1, Free Year 2) and swap between them as needed. Alternatively, handle contest logic outside the subscription system via credits or manual extensions.

Best Regards,
Henry Cowan

1 Like