[INTEGRATION]: POLAR_PAYMENTS

Polar.sh Integration

Add subscription management and payments to billing templates.

Time: ~15 minutes

Level: Intermediate

[0x00] OVERVIEW

Fabrk uses Polar.sh for subscription billing. Configure it to enable the Billing Dashboard and Pricing Page templates.

[WHAT YOU'LL INTEGRATE]:

Checkout session creation
Subscription management
Webhook handling for payment events
Customer portal integration

[0x01] ENVIRONMENT VARIABLES

1$# .env.local
2$POLAR_ACCESS_TOKEN="your-polar-access-token"
3$POLAR_WEBHOOK_SECRET="your-webhook-secret"
4$NEXT_PUBLIC_POLAR_ORGANIZATION_ID="your-org-id"

[0x02] CREATE CHECKOUT SESSION

1// app/api/polar/checkout/route.ts
2import { polar } from "@/lib/polar";
3import { auth } from "@/lib/auth";
4
5export async function POST(req: Request) {
6  const session = await auth();
7  if (!session?.user) {
8    return Response.json({ error: "Unauthorized" }, { status: 401 });
9  }
10
11  const { priceId } = await req.json();
12
13  const checkout = await polar.checkouts.create({
14    priceId,
15    customerEmail: session.user.email,
16    successUrl: `${process.env.NEXT_PUBLIC_URL}/billing?success=true`,
17  });
18
19  return Response.json({ url: checkout.url });
20}

[0x03] WEBHOOK HANDLER

Handle subscription events in app/api/webhooks/polar/route.ts

1import { prisma } from "@/lib/db";
2
3export async function POST(req: Request) {
4  const event = await req.json();
5
6  if (event.type === "checkout.completed") {
7    await prisma.payment.create({
8      data: {
9        userId: event.data.customerId,
10        amount: event.data.amount,
11        status: "completed",
12      },
13    });
14  }
15
16  return Response.json({ received: true });
17}

[0x04] NEXT STEPS

Add Resend to send payment confirmation emails
View Billing Dashboard template

1// app/api/polar/checkout/route.ts

2import { polar } from "@/lib/polar";

3import { auth } from "@/lib/auth";

5export async function POST(req: Request) {

6 const session = await auth();

7 if (!session?.user) {

8 return Response.json({ error: "Unauthorized" }, { status: 401 });

9 }

11 const { priceId } = await req.json();

13 const checkout = await polar.checkouts.create({

14 priceId,

15 customerEmail: session.user.email,

16 successUrl: `${process.env.NEXT_PUBLIC_URL}/billing?success=true`,

17 });

19 return Response.json({ url: checkout.url });

20}

1import { prisma } from "@/lib/db";

3export async function POST(req: Request) {

4 const event = await req.json();

6 if (event.type === "checkout.completed") {

7 await prisma.payment.create({

8 data: {

9 userId: event.data.customerId,

10 amount: event.data.amount,

11 status: "completed",

12 },

13 });

14 }

16 return Response.json({ received: true });

17}