polar-billing
Polar Billing is a reference for Polar's complete billing infrastructure, covering core entities like checkouts, orders, subscriptions, and transactions alongside their relationships and data flows. It details Stripe integration, subscription lifecycle management including trials and cancellations, proration logic, and benefit grants. The skill maps key services, background task handling, dunning retry strategies, and transaction ledger mechanics to help developers navigate payment workflows end-to-end.
Polar Billing provides comprehensive documentation of billing entities, Stripe integration, subscription lifecycle, and benefit provisioning workflows.
AI-generated summary based on this skill's SKILL.md
Decision gist · record as of 2026-07-26
Polar Billing provides comprehensive documentation of billing entities, Stripe integration, subscription lifecycle, and benefit provisioning workflows. Polar Billing is a reference for Polar's complete billing infrastructure, covering core entities like checkouts, orders, subscriptions, and transactions alongside their relationships and data flows. It details Stripe integration, subscription lifecycle management including trials and cancellations, proration logic, and benefit grants. The skill maps key services, background task handling, dunning retry strategies, and transaction ledger mechanics to help developers navigate payment workflows end-to-end.
Use it when
- Polar Billing implements subscription lifecycle management including creation, renewal, and cancellation workflows.
- Polar Billing integrates Stripe payment processing through checkout flows, webhook handling for payment events.
Verify before relying
Read SKILL.md below before installing (1 file). Open directory: indexed for reading, not audited.
Install
fcakyon/claude-codex-settings/polar-billing · repository language: Python
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How does Polar billing work?
Polar Billing is a reference for Polar's complete billing infrastructure covering core entities like checkouts, orders, subscriptions, and transactions alongside their relationships and data flows. It details Stripe integration, subscription lifecycle management including trials and cancellations, proration logic, and benefit grants, mapping key services, background task handling, dunning retry strategies, and transaction ledger mechanics to help developers navigate payment workflows end-to-end.
What is the subscription lifecycle management process?
Polar Billing implements subscription lifecycle management including creation, renewal, and cancellation workflows. The system handles trial period setup, proration calculations during upgrades or downgrades, dunning and payment retry logic for failed payments, and automated benefit provisioning tied to subscription state transitions. Background tasks via Dramatiq orchestrate these workflows reliably.
How does Polar integrate Stripe payment processing?
Polar Billing integrates Stripe payment processing through checkout flows, webhook handling for payment events, and transaction ledger mechanics. The system processes payments, manages customer billing addresses and tax calculations, handles refunds and disputes, and coordinates with Stripe's payment retry infrastructure for dunning strategies on failed transactions.
How are benefit grants and revocation workflows configured?
Polar Billing configures benefit grants, revocation, and provisioning workflows tied to subscription state changes. Benefits are provisioned when subscriptions activate and revoked upon cancellation or expiration. The system tracks benefit entitlements through the transaction ledger and audit logs, ensuring consistent state across provisioning and revocation events.
What entities and relationships define Polar's billing system?
Polar Billing's core entities include checkouts, orders, subscriptions, and transactions with defined relationships and data flows. The system also covers meter credits and usage tracking, seat-based pricing implementation, payout mechanics, and customer billing address management. These entities interconnect through the transaction ledger and audit logs for complete billing visibility.
How do I debug billing issues like failed payments or missing benefits?
Polar Billing provides debugging support for billing issues including failed payments, proration errors, and missing benefits. The transaction ledger and billing entry audit log track all state changes and payment attempts. Developers can inspect webhook processing logs, dunning retry logic execution, and benefit provisioning workflows to identify root causes and resolve issues systematically.
SKILL.md
Rendered from the published skill. Quoted content, verbatim.
Polar Billing System
Comprehensive guide to Polar's billing infrastructure, covering entities, flows, Stripe integration, and benefit provisioning.
Quick Reference
Checkout → Payment → Order → Transaction → Benefits
↓
Subscription (if recurring)
↓
Subscription Cycle → Order → ...
Table of Contents
- Core Entities
- Entity Relationships
- Main Services
- Dramatiq Background Tasks
- Stripe Integration
- Subscription Lifecycle
- Proration System
- Benefits & Credits
- Dunning & Payment Retry
- Transaction Ledger
- Key File Locations
1. Core Entities
(truncated - see the full file via the links below)
File tree — 1 file
plugins/polar-skills/skills/polar-billing/SKILL.md
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Understand Polar's billing infrastructure and payment flow architecture”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
This skill guides you through migrating your payment operations to Polar from competing platforms like Stripe Billing, Paddle, Lemon Squeezy, and Gumroad. It covers data mapping, customer import, subscription creation, webhook setup, and strategies for hard cutover or gradual parallel operation to minimize revenue disruption.
Laravel Cashier Paddle provides a fluent interface for building subscription billing and payment workflows with Paddle in Laravel applications. Set up billable models, create checkout sessions, manage subscription lifecycles, and handle webhook events with built-in support for multi-product subscriptions, trial periods, and transaction management.
Subscription Billing guides you through implementing recurring payment systems across major e-commerce platforms and headless storefronts. It covers the full lifecycle—from initial checkout through failed payment recovery, plan modifications, and customer-controlled cancellation—with platform-specific setup instructions for Shopify, WooCommerce, BigCommerce, and Stripe Subscriptions.
Laravel Cashier Stripe streamlines Stripe integration in Laravel apps with built-in subscription billing, recurring payments, and customer management. The skill covers setup, subscription lifecycle, payment methods, checkout flows, invoicing, and webhook handling—everything needed to add billing to your Laravel application.
Handle real customer billing operations—from subscription disputes to refund triage—by connecting to Stripe and other billing platforms. The skill guides you through identifying the customer, classifying the issue, and taking the safest reversible action, whether that's restoring self-serve controls, fixing duplicate charges, or processing a refund. It also surfaces product gaps so billing friction doesn't become a support loop.
This skill diagnoses cost overruns in the ECC Tools GitHub App by mapping webhook ingress, queue workers, and PR creation logic to pinpoint PR multiplication, quota races, and premium-tier leakage. It separates repo-side burn root causes from customer billing impact and prioritizes fixes by cost impact rather than code neatness.
More skills finance-billing-ops (MIT) · paypal-integration (MIT) · stripe-integration (MIT) · payments (MIT) · Stripe Implementer (unlicensed)