Polar integration
Polar revenue attribution
DataFair connects your Polar payments to the visits that led to them, so you can see which traffic sources earn money for your developer products and subscriptions, not just which ones send visitors.
What you see once Polar is connected
- Revenue by channel, referrer, campaign, landing page, country, device and browser
- Revenue per visitor and conversion rate next to your traffic, on one chart
- Every visitor journey that ended in a payment, from the first page to the purchase
- Refunds and disputes taken off the source that earned the sale
- Recurring revenue (MRR) by source, for subscriptions
How payments are matched to visitors
The DataFair script gives every visitor an anonymous id. When that visitor pays, the id travels with the payment and DataFair credits the sale to the visit that brought them.
Add df_visitor_id to the checkout metadata you send to Polar.
A payment that arrives without an id still counts in your revenue totals. It just has no traffic source.
Connect Polar in a few minutes
- In DataFair, open Integrations, choose Polar and copy your webhook URL.
- Open Polar and go to your organization’s Settings, then Webhooks.
- Click Add Endpoint and paste your DataFair webhook URL.
- Set Format to Raw.
- Paste your signing secret into Secret. If you let Polar generate one instead, copy it back into DataFair.
- Tick the events listed below and save.
- Use the same secret in DataFair and save.
Polar events DataFair listens to
Every webhook is checked against its signature before anything is stored, and the secret is encrypted at rest.
- order.paid
- order.refunded
- subscription.canceled
Good to know
The sandbox at sandbox.polar.sh has its own webhooks.
Questions
- Do I need to write code to track Polar revenue?
- A small change to your checkout. Add df_visitor_id to the checkout metadata you send to Polar.
- What happens to refunds?
- When Polar reports a refund or a dispute, DataFair takes it off the source that earned the original sale, so your revenue by channel stays honest.
- Which plan do I need?
- Every plan includes revenue attribution. Starter includes one revenue provider connection; Growth and Scale include several. Starter is $5.99 a month at launch and falls to $3.99 as the community grows. Growth goes from $14.99 to $9.99, and Scale from $49.99 to $29.99. Every customer moves to the lower price at their next renewal.
- Can I use Polar with another payment provider?
- Yes, on Growth and Scale you can connect several providers to one website, and each payment is attributed the same way.