INTEGRATIONS
Polar
How to connect Polar to NoChurn: what to paste, what NoChurn does in Polar and what it reads.
Connect
In NoChurn, test mode first, open Integrations, pick Polar and paste the fields below (or send them to POST /v1/billing_connections with provider: "polar"). Use the provider’s test or sandbox credentials in test mode. Secrets are stored encrypted and never returned by the API.
| Field | Where to find it |
|---|---|
access_tokenSECRET | Settings › Developers › Organization access token (a sandbox.polar.sh token in Test mode) |
Create a webhook endpoint in Polar › Settings › Webhooks with webhook_url, format Raw and API version 2026-10 (the version NoChurn reads), then paste its secret (whsec_…) here.
What NoChurn does
| Retries | Polar retries the payment (its own retry settings). NoChurn sends the recovery emails. |
|---|---|
| Card update | The recovery emails link to Polar’s own page where the customer updates the payment method. |
| Cancel flow offers | Applied in Polar: discount, pause. An offer the provider cannot apply reaches your backend as a billing.*_requested webhook. |
| Cancellation | A cancellation requested in the cancel flow is carried out in Polar. |
| Disputes | Polar handles disputes. NoChurn shows them on the customer’s timeline. |
| Events | NoChurn follows Polar’s webhooks. |
| Import | The last 12 months are imported when you connect (POST /v1/billing_connections/{id}/backfill imports again). |
Fixed by Polar, not by a setting: retries, disputes. The rest can be changed per connection with PATCH /v1/billing_connections/{id}.
What NoChurn reads
- Customers and subscriptions
- Orders and failures
- Discounts and products, to build offers
- Disputes, read only
What stays with Polar: checkout, payments and payment recovery; sales tax and invoices, as the merchant of record; disputes and refunds. More on the Polar integration page.