polar
Polar payment platform integration for monetization, subscriptions, and license keys. Use when implementing checkout, managing products, or building customer portals.
When & Why to Use This Skill
This Claude skill facilitates seamless integration with the Polar payment platform, empowering developers to automate monetization, subscription billing, and license key management. It streamlines the technical overhead of implementing secure checkouts and customer portals, making it an essential tool for SaaS founders and digital creators looking to scale their revenue infrastructure.
Use Cases
- SaaS Subscription Implementation: Quickly generate code and logic for recurring billing, including plan management and subscription lifecycle events.
- Digital Product Checkout: Set up secure, merchant-of-record checkout flows for one-time purchases of software, assets, or digital content.
- Automated License Key Management: Integrate systems to issue, track, and validate software license keys to protect intellectual property.
- Webhook Infrastructure Setup: Build and debug robust webhook handlers to process real-time payment notifications and synchronize application state.
- Customer Self-Service Portals: Develop interfaces that allow users to manage their own billing history, active subscriptions, and payment methods.
| name | polar |
|---|---|
| description | Polar payment platform integration for monetization, subscriptions, and license keys. Use when implementing checkout, managing products, or building customer portals. |
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.