plan-change

Razorpay Plan Change (Upgrade / Downgrade)

The correct pattern for plan changes is deferred cancellation — create the new subscription first, let the webhook cancel the old one after payment succeeds. This prevents downtime if the user abandons checkout.

Why NOT Cancel-Then-Create

BAD:  Cancel old → Create new → User abandons checkout → No subscription!
GOOD: Create new (with note) → User pays → Webhook cancels old → Seamless

API Route: Change Plan

// app/api/billing/change-plan/route.ts
export async function POST(request: Request) {
  const user = await getAuthenticatedUser(request);
  if (!user) return new Response("Unauthorized", { status: 401 });

  const { newPlanKey } = await request.json();

  try {
    // 1. Get current subscription
    const current = await getActiveSubscriptionByUserId(user.id);
    if (!current) {
      return Response.json({ error: "No active subscription" }, { status: 400 });
    }

    // 2. Prevent same-plan change
    if (current.planKey === newPlanKey) {
      return Response.json({ error: "Already on this plan" }, { status: 409 });
    }

    // 3. Create NEW subscription with reference to old one
    const planId = planIdFor(newPlanKey);
    const subscription = await razorpay.subscriptions.create({
      plan_id: planId,
      total_count: totalCountFor(newPlanKey),
      quantity: 1,
      customer_notify: 1,
      notes: {
        userId: user.id,
        planKey: newPlanKey,
        replacesSubscription: current.razorpaySubscriptionId,  // KEY: signals webhook
      },
    });

    // 4. DO NOT cancel old subscription here — webhook handles it
    // 5. DO NOT create DB row here — webhook auto-creates on activation

    return Response.json({
      shortUrl: subscription.short_url,
      subscriptionId: subscription.id,
    });
  } catch (error) {
    console.error("Failed to change plan:", error);
    return Response.json({ error: "Something went wrong" }, { status: 500 });
  }
}

Webhook: Handle replacesSubscription