polar-sh-nextjs-convex

To integrate Polar.sh billing, scaffold checkout and customer portal routes in Next.js App Router, then use Convex mutations to sync webhook events into entitlements. Install the Polar SDK and configure environment variables for the webhook handler.

Polar webhooks sync with Convex by sending billing events to a Next.js webhook ingestion route, which then triggers Convex mutations. This webhook-driven architecture updates Convex entitlements for app authorization based on subscription and purchase data.

Yes, Polar handles both subscriptions and one-time purchases in Next.js. The integration provides checkout routes for both purchase types and syncs the billing data to Convex to maintain a consistent entitlement source for authorization.

The best way to manage customer billing portals is scaffolding a dedicated Next.js App Router portal route using the Polar SDK. This lets users manage their subscriptions while Convex stays synced as the entitlement authority via webhooks.

Yes, a webhook ingestion route is required to keep Convex entitlements updated. The webhook handler receives Polar billing events and executes Convex mutations to sync subscription and purchase state for app authorization.

You need to install the @polar-sh/sdk and @polar-sh/nextjs packages using pnpm. These dependencies provide the tools to scaffold checkout routes and configure the Polar billing integration within your Next.js project.