PayPal integration
PayPal revenue attribution
DataFair connects your PayPal payments to the visits that led to them, so you can see which traffic sources earn money for your payments and subscriptions, not just which ones send visitors.
What you see once PayPal 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.
Set custom_id on the purchase unit (or the subscription) to the visitor’s df_visitor_id. PayPal doesn’t send it otherwise, so untagged payments stay unattributed.
A payment that arrives without an id still counts in your revenue totals. It just has no traffic source.
Connect PayPal in a few minutes
- In DataFair, open Integrations, choose PayPal and copy your webhook URL.
- Sign in at developer.paypal.com with your PayPal business account and open Apps & Credentials.
- Choose Live (or Sandbox while testing) and open your app. If there is none, click Create App.
- Under Webhooks, click Add Webhook and paste your DataFair webhook URL.
- Tick the events listed below and save.
- Copy the Webhook ID shown next to the new webhook.
- Paste the Webhook ID into DataFair and save.
PayPal events DataFair listens to
Every webhook is checked against its signature before anything is stored, and the secret is encrypted at rest.
- PAYMENT.CAPTURE.COMPLETED
- PAYMENT.CAPTURE.DENIED
- PAYMENT.CAPTURE.REFUNDED
- PAYMENT.SALE.COMPLETED
- PAYMENT.SALE.REFUNDED
- CUSTOMER.DISPUTE.CREATED
- BILLING.SUBSCRIPTION.CANCELLED
Good to know
PayPal has no signing secret. DataFair checks every delivery against PayPal’s own certificate and this Webhook ID, so no API keys are needed. Sandbox and Live have separate webhooks.
Questions
- Do I need to write code to track PayPal revenue?
- A small change to your checkout. Set custom_id on the purchase unit (or the subscription) to the visitor’s df_visitor_id. PayPal doesn’t send it otherwise, so untagged payments stay unattributed.
- What happens to refunds?
- When PayPal 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 PayPal 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.