Docs

Billing

How commerce, Polar, internal Varel sales, and entitlements fit together.

1

The commerce catalog owns offer IDs, billing types, feature copy, and entitlements; Polar product IDs live in POLAR_PRODUCT_IDS keyed by offer ID.

2

Polar is the only supported customer billing provider in the core, with checkout, customer portal sessions, webhooks, and normalized repository writes.

3

Internal Varel Polar sales code stays under internal-sales, polar-sync, and polar:doctor and must not ship to generated repos.

4

GitHub repository access benefits require buyers to open the Polar Customer Portal and connect GitHub before Polar can grant repo access.

5

Entitlements resolve from paid one-time purchases, unexpired one-time purchase bonus entitlements, and active or trialing subscriptions.

6

Temporary access bundled with a one-time purchase is app-side entitlement logic; auto-billing after a free period requires a separate Polar subscription trial checkout.