Subscriptions

When products belong to the same product line, customers can move between them, and Hexclave handles the proration and timing for you.

Switching plans

For example, upgrading from Pro to Enterprise:

app/components/upgrade-button.tsx

"use client";
import { useUser } from "@hexclave/next";  // replace `next` with the correct framework SDK package

export default function UpgradeButton() {
  const user = useUser({ or: 'redirect' });

  return (
    <button onClick={async () => {
      await user.switchSubscription({
        fromProductId: "prod_pro",
        toProductId: "prod_enterprise",
        // optional: priceId, quantity (quantity > 1 requires a stackable product)
      });
    }}>
      Upgrade to Enterprise
    </button>
  );
}

Switching plans requires the customer to have a default payment method saved (see Billing & Invoices). The switch happens immediately and the charge is prorated automatically. You cannot switch to an add-on, and a free trial on the destination product is not applied.

Canceling a subscription

cancelSubscription is called on the app instance rather than the user object:

Client Component
Server

"use client";
import { useHexclaveApp } from "@hexclave/next";  // replace `next` with the correct framework SDK package

export default function CancelButton({ productId }: { productId: string }) {
  const app = useHexclaveApp();
  return (
    <button onClick={async () => {
      await app.cancelSubscription({ productId });
    }}>
      Cancel Subscription
    </button>
  );
}

import { hexclaveServerApp } from "@/hexclave/server";

// Cancel for the current user
await hexclaveServerApp.cancelSubscription({ productId: "prod_pro" });

// Cancel for a team
await hexclaveServerApp.cancelSubscription({
  productId: "prod_team_plan",
  teamId: "team-id",
});

cancelSubscription is immediate for live, processor-backed subscriptions — access ends now. Subscriptions created in test mode or via grantProduct (no processor subscription) are marked to end at the current period end, so access continues until then. Pass subscriptionId when canceling an inline product that has no catalog productId. One-time purchases cannot be canceled; refund them instead.

Reading subscription state

Each subscription product returned by useProducts / listProducts carries a subscription field with the current period end and cancellation state, plus switchOptions listing the other products in the same product line the customer can switch to.

Checkout & Purchases - start a subscription
Billing & Invoices - payment methods and billing history
Refunds - reverse a charge and optionally end the subscription

Getting Started

Going Further

Apps

Integrations

Other

Switching plans

Canceling a subscription

Reading subscription state

​Switching plans

​Canceling a subscription

​Reading subscription state

​Related

Switching plans

Canceling a subscription

Reading subscription state

Related