Pass the visitor id to checkout

Attribution is only exact when the purchase carries the visitor id. The pixel exposes the current visitor id as window.trk.vid — pass it into your checkout and TrackRev joins the resulting charge to the click with certainty. Without it, TrackRev falls back to matching on email, which is a good safety net but not exact.

Read window.trk.vid in the browser at the moment you start checkout. On the server, the same value is available as the vid cookie.

Hosted checkouts: nothing to wire

If your buy buttons are hosted links or embeds — Stripe Payment Links, <stripe-buy-button>, <stripe-pricing-table>, Polar checkout links, Creem payment links, Dodo static payment links, or Paddle hosted checkouts — the pixel decorates them automatically with the visitor id in each provider’s format. You’re done; the sections below are for checkouts you create through a provider’s API.

To exclude a specific element from decoration, add data-trk-no-decorate to it. To see what the pixel decorated on a page, open it with ?trk_test=1 and check the browser console.

By processor

Stripe
Paddle
Polar / Creem / Dodo
Lemon Squeezy

Checkout Session — set client_reference_id:

// server-side, when creating the session
import { cookies } from "next/headers";
const vid = (await cookies()).get("vid")?.value;

const session = await stripe.checkout.sessions.create({
  mode: "subscription",
  line_items: [/* ... */],
  success_url: "https://yourapp.com/thanks",
  client_reference_id: vid, // ← the join key
});

Payment Links / Pricing Table — append the id or set the attribute:

https://buy.stripe.com/abc123?client_reference_id=<vid>

<stripe-pricing-table client-reference-id="<vid>" ...></stripe-pricing-table>

You can also set metadata.vid on the PaymentIntent as an alternative.

Paddle.js — pass customData:

Paddle.Checkout.open({
  items: [{ priceId: "pri_123", quantity: 1 }],
  customData: { vid: window.trk?.vid },
});

Or append to a hosted link: ?customData[vid]=<vid>.

Pass metadata when creating the checkout via API:

// Polar / Creem / Dodo checkout
metadata: { vid: window.trk?.vid }

Building a hosted-link URL yourself (the pixel already does this on your pages)? The format differs per provider:

Provider	Hosted-link parameter
Polar (`buy.polar.sh`)	`?vid=<vid>` — per-visit query params are stored on the checkout’s metadata
Creem (`creem.io/payment`)	`?metadata[vid]=<vid>`
Dodo (`checkout.dodopayments.com`)	`?metadata_vid=<vid>` — Dodo takes metadata as flat `metadata_*` params

Lemon Squeezy attribution is email-only — the vid isn’t read back from orders. Make sure you identify the buyer’s email before checkout:

window.trk?.identify("customer@example.com");

You may still pass custom data for your own records: checkout_data: { custom: { vid: window.trk?.vid } }.

Verify it’s working

After wiring this up, go to Integrations → Verify your checkout setup → Check attribution setup. TrackRev inspects recent checkouts and confirms the vid is present and matching. See Connect Stripe → Verify your setup for what each result means.

The pixel must be running on the page where checkout starts so window.trk.vid is defined there. If the verifier says “vid unmatched”, that’s the usual cause.

Get started

Links & Analytics

Revenue Attribution

Affiliate & Partners

For affiliates

Free tools

Account & workspace

Guides

Pass the visitor id to checkout

Hosted checkouts: nothing to wire

By processor

Verify it’s working

​Hosted checkouts: nothing to wire

​By processor

​Verify it’s working

Hosted checkouts: nothing to wire

By processor

Verify it’s working