PayPal
TrueMetriks turns completed PayPal payments into Purchases and pairs them with the same sale reported by your funnel or CRM. Here is how to set it up.
Set this up with AI
Copy this prompt into ChatGPT, Claude or whichever AI you use. It carries this whole guide, the pages it depends on, and a link to every video, so it can walk you through it one step at a time.
Set up PayPal
TrueMetriks turns completed PayPal payments into Purchases and pairs them with the same sale reported by your funnel or CRM, so PayPal revenue stops being invisible next to your Stripe sales. Set up takes about two minutes and needs no API keys.
Step 1 - Open the PayPal tile in TrueMetriks
In TrueMetriks, go to Settings > Integrations and click the highlighted PayPal tile.
Integrations
Connect third-party data sources to fire events into TrueMetriks.
Typeform
Connected
Stripe
Connected
Whop
Not connected
PayPal
Not connected
Webhooks
Receiving 4, sending 2
Step 2 - Click Set up PayPal
Click the highlighted Set up PayPal button. TrueMetriks creates your unique webhook URL and the page flips to a green Connected pill. Nothing is sent to PayPal yet - you paste the URL there yourself in the next step.
PayPal Not connected
Set up takes about two minutes in your PayPal Developer Dashboard. No API keys needed - you just paste a URL and pick which events PayPal sends.
Creates your unique webhook URL. Nothing is sent to PayPal - you paste the URL there yourself.
Step 3 - Copy your webhook URL and add it in PayPal
On the connected PayPal page, click the highlighted Copy button next to Your webhook URL. The URL looks like https://q.<your-domain>/api/webhooks/paypal/....
Then, in a new tab, open your PayPal Developer Dashboard and add the webhook:
- Go to developer.paypal.com, open Apps & Credentials, and select your LIVE app (or create one - any name works).
- Scroll to Webhooks and click Add Webhook.
- Paste the URL you copied into the Webhook URL field.
PayPal Connected
Completed payments count as Purchases. Refunds, disputes and other PayPal noise are ignored automatically.
Your webhook URL
Set up in PayPal (one time):
- Go to developer.paypal.com → Apps & Credentials → select your LIVE app (or create one - any name works).
- Scroll to Webhooks and click Add Webhook.
- Paste the URL above into the Webhook URL field.
- Under Event types, subscribe to exactly these events:
Anything else PayPal sends is safely ignored and shows below as "ignored".
Step 4 - Subscribe to the two events
Under Event types, subscribe to exactly these two events:
CHECKOUT.ORDER.APPROVEDCHECKOUT.ORDER.COMPLETED
Together they cover completed PayPal checkout payments. Anything else PayPal sends is safely ignored (it shows below as ignored, which is correct). Save the webhook in PayPal. The next completed payment appears in Recent deliveries within seconds.
Verify
Complete a PayPal checkout payment and the matching Purchase event shows up on the PayPal page under Recent deliveries, and in the TrueMetriks dashboard within a few seconds. Refunds, disputes, and other PayPal noise show as ignored on purpose - only completed payments count.
If the buyer's journey is connected to an ad, that Purchase also lands in your connected ad platforms: Facebook CAPI, Google Ads, GA4, TikTok. And if the same sale is also reported by another source (your Stripe checkout, a funnel, or your CRM), the two are paired automatically so the revenue is only counted once.
What PayPal tracks
- Completed checkout payments count as Purchases, identified by the payer's email.
- Subscription renewals are not captured in this version. TrueMetriks tracks one-time PayPal checkout payments only, so do not rely on this for recurring subscription revenue.
- Refunds, disputes, and other events are ignored automatically - they appear as
ignoredin Recent deliveries. - One PayPal setup per site. To rotate the URL, click Disconnect (confirm), then Set up PayPal again to create a fresh URL.
Frequently asked questions
Which PayPal events should I subscribe to?
Exactly two: CHECKOUT.ORDER.APPROVED and CHECKOUT.ORDER.COMPLETED. Together they cover completed PayPal checkout payments. Anything else PayPal sends is ignored automatically.
Does PayPal track subscription renewals?
Not in this version. TrueMetriks tracks one-time PayPal checkout payments. Recurring PayPal subscription renewals are not captured yet, so do not rely on this for subscription revenue.
Why do some PayPal events show as ignored?
Refunds, disputes, and other non-payment events are ignored on purpose - only completed payments count as Purchases. Seeing ignored in Recent deliveries is correct, not an error.
Will a PayPal sale double-count with my funnel or CRM?
No. A PayPal purchase and the same sale reported by another source are paired automatically, so the revenue is counted once.