6 solution docs
Polar solution docs
Merchant of record for developers. Polar sells to your customer, so tax is its job.
Pick Polar and all 6 land in docs/solutions/polar/, next to the rules and skills that reference them.
Every Polar doc in the registry
Tags: billing · chargebacks · checklist · checkout · compliance · disputes · entitlements · environments · idempotency · launch · lifetime-deal · merchant-of-record · migration · one-time-payments · polar · postgres · production · refunds · reliability · sales-tax · sandbox · signatures · standard-webhooks · stripe · subscriptions · tax · vat · webhooks
Merchant of record explained, what Polar takes on that Stripe leaves with you
With Stripe you are the seller and you owe VAT, GST and US sales tax yourself. Polar sells on your behalf and carries that liability. What actually changes, what it costs, and how little of it reaches your code.
polar · stripe · merchant-of-record · tax
Moving from Stripe to Polar without breaking existing customers
You cannot transfer live Stripe subscriptions to Polar. Sell new customers on Polar, keep Stripe's webhook alive for the ones you have, move them at renewal, and let the provider-neutral billing rows carry access through the whole overlap.
polar · stripe · migration · subscriptions
One-time and subscription products on Polar, from lifetime deal to renewal
Polar sells one price per product, so a plan sold monthly, yearly and for life is three products. How each kind checks out, which webhook proves it was paid, where it is stored, and how access resolves when a customer holds both.
polar · one-time-payments · lifetime-deal · subscriptions
Refunds and disputes on Polar, and taking access back exactly once
A refund arrives as order.refunded with the whole order. A dispute arrives as nothing at all. How this repo revokes a lifetime deal in both cases, why partial refunds keep access, and why a late paid delivery cannot give it back.
polar · refunds · disputes · chargebacks
Polar sandbox to production, the checklist that stops launch-day silence
Sandbox and production are separate Polar deployments with separate tokens, product ids and webhook secrets. Nothing carries over. Everything that has to be recreated, in order, and how to prove it worked.
polar · sandbox · production · launch
Polar webhooks arrive twice and sign two ways, make the handler survive both
At-least-once delivery means duplicates and out-of-order events are normal traffic, and Polar changed its signing key format in September 2026. Verify with both keys, claim the webhook-id before any write, re-read subscriptions and let orders only move forward.
polar · webhooks · idempotency · standard-webhooks