Attribute Stripe Payment Links

Payment Link revenue is imported like any Stripe payment. Linking it to a visit takes one extra step, because a link can't carry a different visitor ID for each buyer on its own.

Your options

• Switch to Checkout Sessions created by your server. This is the most reliable way; see Stripe Checkout.
• Keep Payment Links and add a small webhook that copies the visitor ID into metadata MetricRaven reads (below).
• Revenue only: do nothing. Payments are still imported, just not linked to visits.

Link Payment Links to visits with a webhook

1. Add the visitor ID to the link when it's clicked

   Your website

   Copy

   1

   2

   3

   4

   5

   6

   7

   8

   9

   10

   // On pages with Payment Link buttons, after the MetricRaven script.
   // Adjust the prefix if your links use a custom Stripe domain.
   document.addEventListener("click", (event) => {
     const link = event.target.closest?.('a[href^="https://buy.stripe.com/"]');
     const visitorId = window.analytics?.getVisitorId?.();
     if (!link || !visitorId) return;
     const url = new URL(link.href);
     url.searchParams.set("client_reference_id", visitorId);
     link.href = url.toString();
   });

2. Copy it into metadata when the checkout completes

   In Stripe, add a webhook endpoint for checkout.session.completed, then handle it on your server:

   Webhook handler

   Copy

   1

   2

   3

   4

   5

   6

   7

   8

   9

   10

   11

   // Your Stripe webhook endpoint, for the checkout.session.completed event.
   // stripe is your initialized Stripe client; verify the webhook signature first.
   const session = event.data.object;
   const visitorId = session.client_reference_id;
   if (visitorId && /^(?:[0-9a-f]{24}|[0-9a-f]{32})$/.test(visitorId)) {
     const metadata = { metricraven_visitor_id: visitorId };
     // One-time payments: the PaymentIntent.
     if (session.payment_intent) await stripe.paymentIntents.update(session.payment_intent, { metadata });
     // Subscriptions (and links that create customers): the Customer, so renewals are linked too.
     if (session.customer) await stripe.customers.update(session.customer, { metadata });
   }

   The webhook needs a Stripe key with write access to PaymentIntents and Customers.

Plan names from the link itself

A Payment Link's own metadata is the same for every buyer, so it can't identify a visitor, but it can label the plan. Set metricraven_plan in the link's payment_intent_data.metadata (one-time) or subscription_data.metadata (subscriptions) when you create it with the API.