Quick pre-launch payments check for a Polar-powered web app. Use when asked ”am I ready to launch?”, ”go live with Polar”, or ”switch from sandbox to production”, to catch the mistakes that most often
A 15-minute go/no-go check before you take real payments with Polar. Report each
item as PASS, FAIL or NOT RUN, with the command or evidence. A successful build
or a working checkout URL alone does not mean you're ready.
POLAR_SERVER from sandbox to production.POLAR_SERVER=production, and the access token, product IDs and webhooksecret all come from the production org. Sandbox and production are
separate orgs with separate IDs and secrets.
APP_URL (and your auth URL) is the real HTTPS domain.@polar-sh/sdk requires Node >= 22(node -v; set "engines" and .nvmrc).
git log -p | grep -E 'polar_(oat|pat)_' returns nothing,and .env* is gitignored except .env.example.
subscription.*(and order.* if you sell one-time products).
await request.text()) and verifies itbefore parsing; an invalid signature returns 403.
webhook-id) are ignored.must not unlock the paid tier.
modified_at) cannotrestore access after revocation.
?checkout_id= on the success URL grants nothing (only webhooks grant).who never checked out (Polar returns 422 "Customer does not exist.").
test purchases with real card details: payment processors treat it as card
testing, which can block the card or your account, and it triggers a Polar
account review. Payments, renewals, cancellations and refunds are tested
in the sandbox.
the production org, restricted to your paid product, with maximum
redemptions 1. For a subscription, set the duration to Forever: Polar
doesn't ask for a card on 100%-forever subscriptions, so nothing renews at
full price later. Check out with it as a new user, confirm the production
webhook delivery succeeded in the dashboard and access unlocked, then
cancel the subscription and confirm access behaves as your policy says.
Delete the code afterwards.
npm run build passes in a clean clone (Next.js auto-loads .env.local, sonever move or rename it to test this; use git worktree add).
@example.com emails: Polar rejects undeliverable domains with 422.or a 100% discount code in production (step 5).
https://polar.sh/docs/integrate/webhooks/delivery
Weekly roundup of top Claude Code skills, MCP servers, and AI coding tips.