Polar Integration
Polar is a merchant-of-record platform for digital products, subscriptions, and license keys.
What I Do
- Guide implementation of Polar checkout and payments
- Help with subscription management and billing
- Assist with license key validation
- Set up webhook handlers for payment events
When to Use Me
- Implementing checkout flow for a product
- Adding subscription billing to an app
- Setting up license key validation
- Building a customer portal
- Handling payment webhooks
Quick Start
npm install @polar-sh/sdk
import { Polar } from "@polar-sh/sdk";
const polar = new Polar({
accessToken: process.env.POLAR_ACCESS_TOKEN!,
server: "production", // or "sandbox"
});
Key APIs
| API |
Purpose |
polar.products.* |
Create/manage products and prices |
polar.checkouts.* |
Create checkout sessions |
polar.subscriptions.* |
Manage subscriptions |
polar.orders.* |
View order history |
polar.customers.* |
Customer management |
polar.licenseKeys.* |
Issue and validate licenses |
Environment Variables
| Variable |
Description |
POLAR_ACCESS_TOKEN |
Organization Access Token (OAT) |
POLAR_WEBHOOK_SECRET |
Webhook signing secret |
Common Patterns
Create Checkout
const checkout = await polar.checkouts.create({
productId: "prod_xxx",
successUrl: "https://myapp.com/success",
});
// Redirect to checkout.url
Validate License Key
const result = await polar.licenseKeys.validate({
key: "XXXX-XXXX-XXXX-XXXX",
organizationId: "org_xxx",
});
Handle Webhook
import { validateEvent } from "@polar-sh/sdk/webhooks";
const event = validateEvent(body, signature, process.env.POLAR_WEBHOOK_SECRET!);
// event.type: "subscription.created", "order.created", etc.
Links
majiayu000