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.

Open as text

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

Typeform

Connected

stripe

Stripe

Connected

Whop

Not connected

PayPal

PayPal

Not connected

Webhooks

Receiving 4, sending 2

In TrueMetriks, open Settings → Integrations and click the highlighted PayPal tile.

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.

P

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.

Click Set up PayPal. TrueMetriks creates your unique webhook URL and flips the page to Connected.

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:

  1. Go to developer.paypal.com, open Apps & Credentials, and select your LIVE app (or create one - any name works).
  2. Scroll to Webhooks and click Add Webhook.
  3. Paste the URL you copied into the Webhook URL field.
P

PayPal Connected

Completed payments count as Purchases. Refunds, disputes and other PayPal noise are ignored automatically.

Your webhook URL

https://q.demo-brand.example/api/webhooks/paypal/7d31c9e5f2a8b40d66e1c4a90f2b

Set up in PayPal (one time):

  1. Go to developer.paypal.com → Apps & Credentials → select your LIVE app (or create one - any name works).
  2. Scroll to Webhooks and click Add Webhook.
  3. Paste the URL above into the Webhook URL field.
  4. Under Event types, subscribe to exactly these events:
CHECKOUT.ORDER.APPROVED CHECKOUT.ORDER.COMPLETED

Anything else PayPal sends is safely ignored and shows below as "ignored".

Recent deliveries (2)
Today 13:05:44 accepted Purchase - $997.00 USD, [email protected] payload
Today 10:22:31 ignored PAYMENT.CAPTURE.REFUNDED - not a completed payment, safely ignored payload
Copy the webhook URL, add it in your PayPal Developer Dashboard, and subscribe to the two CHECKOUT.ORDER events.

Step 4 - Subscribe to the two events

Under Event types, subscribe to exactly these two events:

  • CHECKOUT.ORDER.APPROVED
  • CHECKOUT.ORDER.COMPLETED

Together they cover completed PayPal checkout payments. Anything else PayPal sends is ignored on purpose (it shows below as ignored, which is correct). Refunds are recorded a different way, see Refunds. 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 events show as ignored on purpose - only completed payments count here.

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.

Refunds

PayPal refunds are not read from the PayPal webhook. To take a PayPal refund off its sale, send the refund to a TrueMetriks receiving webhook with the event type Refund.

Most people do this with Zapier or Make: a PayPal refund trigger, then a webhook step that POSTs to your Refund webhook URL. Your own backend can POST to it too.

The body must carry the original sale's order ID as order_id. For PayPal that is the PayPal order ID of the original payment: the checkout order's ID, not the capture ID and not the refund's own ID. It is the ID TrueMetriks stored when the payment came in.

Send the refunded amount as refund_amount and the refund's own ID as refund_id. See Refunds by webhook for every field.

The refund is taken off its sale on the sale's date, and it is never sent to your ad platforms. See Refunds on the Revenue page.

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 from PayPal are ignored - they appear as ignored in Recent deliveries. Refunds are taken off their sale through a receiving webhook instead, see Refunds.
  • 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. To take a PayPal refund off your revenue, send it to a receiving webhook instead (see Refunds on this page).

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.

Are PayPal refunds taken off my revenue?

Not from the PayPal webhook. Send each refund to a TrueMetriks receiving webhook with the event type Refund, for example from Zapier or Make, with the PayPal order ID of the original payment as order_id. TrueMetriks then takes it off that sale.

Need help with this?

Reach us instantly on WhatsApp, or send us a message and we will get back to you. On workdays we usually respond in less than 24 hours.

or send us a message