integration recipe · StripeTikTok

Send Stripe purchases to TikTok, server-side.

A Stripe purchase happens off your page, where no pixel fires. Point Stripe at a TracerKit webhook and it reaches TikTok's Events API with the visitor's click ids and hashed email — no code, and verified end to end.

Free sweep — see your server-side readiness before you connect anything. Or start free →

What lands in TikTokEvents API
eventpurchase
emsha256 · hashed before storage
phsha256 · when the tool has it
valueamount + currency
ttclidfrom the landing visit
ttpfrom the landing visit
event_ididempotency + pixel dedupe
ip / uafor match quality, never on events

Raw email and phone are hashed before anything is stored. IP and user agent ride only the delivery, never the event log.

set it up

Three steps. No deploy.

1

Create the webhook in TracerKit

On your site's page in the dashboard, add a conversion webhook with the Stripe preset. You get a URL once — it's the only credential, and only its hash is stored.

2

Paste it into Stripe

In Stripe → Developers → Webhooks, add an endpoint with your TracerKit URL and subscribe it to checkout.session.completed. Other event types answer 200 and are ignored, so Stripe never retries or disables the endpoint.

3

Connect TikTok with server-side forwarding on

Add TikTok as a destination with an Events API access token and the pixel code from TikTok Events Manager, and turn on server-side forwarding. From the next purchase onward, every conversion is enqueued to TikTok's Events API.

join the visitor

Set client_reference_id to the visitor's TracerKit id when you create the Checkout Session (the loader exposes it as tracerkit.anonymousId). The purchase then joins the visitor's click ids directly; without it, TracerKit falls back to the hashed email.

Sites that enforce per-field consent skip this join: the conversion then carries only what Stripe sent, with no click ids from the visit.

sign the webhook

Copy the endpoint's signing secret (whsec_…) from the Stripe dashboard into the hook. TracerKit verifies the Stripe-Signature header, including the timestamp, on every delivery. Until a secret is set, the unguessable URL is the only credential.

why server-side

TikTok can only optimise on what it receives.

It arrives even when the pixel didn't fire.

The conversion comes from Stripe's servers, so blockers, ITP and a visitor who closed the tab before the thank-you page loaded don't lose it.

It matches to a real visit.

TikTok matches on the ttclid click id and ttp cookie from the landing hit, plus hashed email and phone.

It's counted once.

The server event carries the same event id as the pixel fire, so TikTok dedupes the pair.

You can prove it happened.

Most tools stop at "sent". TracerKit records each delivery's outcome and reconciles what it observed against what TikTok reports, so a silent break shows up as drift, not as a bad quarter.

questions

Asked and answered.

Do I need a developer?+

No. Creating the webhook and pasting the URL into Stripe is the whole install. Threading the visitor id through is one optional line if you want direct click-id matching instead of email matching.

Will this double count against my TikTok pixel?+

The server event carries the same event id as the pixel fire, so TikTok dedupes the pair.

What if the visitor blocked the pixel?+

That's the point of server-side. The Stripe conversion arrives from Stripe's servers, not the visitor's browser, so ad blockers and ITP never see it. TracerKit matches it back to the visitor's landing visit by the hashed email or the visitor id you threaded through.

How do I know it's working?+

Each webhook shows when it last received a delivery, every forwarded event shows its delivery status per destination, and reconciliation compares what TracerKit observed against what TikTok reports — so drift is a number you see, not a hunch.

What does it cost?+

Server-side forwarding is on the Server-side tier at a flat monthly price per site. There is no per-conversion metering, so a busy checkout day never becomes a surprise bill.

Every Stripe purchase, in the light.

Tag management is free forever. Server-side forwarding starts with a 14-day trial — no card, no per-conversion metering.