Paddle integration
Paddle revenue attribution
DataFair connects your Paddle payments to the visits that led to them, so you can see which traffic sources earn money for your SaaS subscriptions, not just which ones send visitors.
What you see once Paddle 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.
Pass df_visitor_id in customData when you open Paddle Checkout.
A payment that arrives without an id still counts in your revenue totals. It just has no traffic source.
Connect Paddle in a few minutes
- In DataFair, open Integrations, choose Paddle and copy your webhook URL.
- Open Paddle and go to Developer tools, then Notifications.
- Click New destination and choose Webhook.
- Paste your DataFair webhook URL, tick the events listed below, and save.
- Open the destination you just made and copy its Secret key.
- Paste the signing secret into DataFair and save.
Paddle events DataFair listens to
Every webhook is checked against its signature before anything is stored, and the secret is encrypted at rest.
- transaction.completed
- transaction.payment_failed
- adjustment.created
- adjustment.updated
- subscription.canceled
Good to know
The sandbox has its own destinations and secrets. Use sandbox-vendors.paddle.com while testing.
Questions
- Do I need to write code to track Paddle revenue?
- A small change to your checkout. Pass df_visitor_id in customData when you open Paddle Checkout.
- What happens to refunds?
- When Paddle 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 Paddle 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.