add-billing

Automates Polar billing integration for subscriptions, payments, and customer management.

4|Updated Oct 24, 2025
One-click install
npx skills add https://github.com/tech-with-seth/iridium --skill add-billing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-billing
Source: https://github.com/tech-with-seth/iridium/tree/main/.github/skills/add-billing
Command: npx skills add https://github.com/tech-with-seth/iridium --skill add-billing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Polar billing integration for subscriptions and payments, enabling seamless checkout flows and customer management within your app.

Core Features & Use Cases

  • Checkout integration: Bridge your app with Polar Checkout for secure payment processing.
  • Customer portal: Provide a self-serve billing portal for subscriptions and invoices.
  • Webhooks & automation: Keep your database and user access in sync via webhook events.

Quick Start

Set environment variables POLAR_ACCESS_TOKEN, POLAR_WEBHOOK_SECRET, and POLAR_SERVER. Implement the Checkout Route to Polar Checkout and link it to a user via customerExternalId. Enable the Customer Portal and Webhook Handler, then test the flow in sandbox mode.

Frequently Asked Questions about add-billing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate Polar billing for subscriptions and payments in my app?

To integrate Polar billing, you need to set environment variables for your access token, webhook secret, and server. You then implement checkout routes, enable the customer portal, and configure webhook handlers to sync your database and user access.

How do I handle Polar payment webhooks to keep my database in sync?

Handling Polar payment webhooks involves implementing a webhook handler that verifies the incoming event using your Polar webhook secret. Once verified, the handler processes the event to update your database and synchronize user access based on the webhook payload.

How does the Polar customer portal work for subscription management?

The Polar customer portal provides a self-serve billing interface for your users. By enabling the portal within your app architecture, customers can independently manage their subscriptions, view invoices, and update their payment methods.

Do I need environment secrets to set up Polar checkout flows?

Yes, setting up Polar checkout flows requires specific environment secrets. You must configure your POLAR_ACCESS_TOKEN, POLAR_WEBHOOK_SECRET, and POLAR_SERVER environment variables to securely bridge your app with Polar Checkout and handle payments.

Can I link a Polar checkout session to a specific user in my application?

Yes, you can link a Polar checkout session to a specific user. When implementing the checkout route to Polar Checkout, you use the customerExternalId parameter to associate the checkout session with the corresponding user record in your app.

What is the best way to test Polar billing integration before going live?

The best way to test Polar billing integration is by using sandbox mode. After wiring your checkout routes, customer portal, and webhook handlers, you can test the entire payment and subscription flow safely in the sandbox environment before production deployment.