Attribute Stripe PaymentIntents

Building your own payment form with the Payment Element or the PaymentIntents API? Add the visitor ID to the PaymentIntent's metadata when you create it.

First connect Stripe so payments are imported: see Connect Stripe.

Set it up

1. Send the visitor ID to your server

   Include it in the request that creates the payment:

   Browser

   Copy

   1

   2

   3

   4

   // Read this in the visitor's browser when they start checkout.
   const visitorId = window.analytics?.getVisitorId() ?? null;
   // Send visitorId to your own checkout endpoint alongside its usual request data.
   // Use the authenticated user ID from your backend; do not trust a browser-supplied user ID.

2. Add metadata when creating the PaymentIntent

   Server

   Copy

   1

   2

   3

   4

   5

   6

   7

   8

   9

   10

   11

   12

   13

   // Your server: create the PaymentIntent for the Payment Element.
   // visitorId came from the browser; authenticatedUser from your session.
   const intent = await stripe.paymentIntents.create({
     amount: 2900,
     currency: "usd",
     automatic_payment_methods: { enabled: true },
     metadata: {
       metricraven_visitor_id: visitorId || "",
       metricraven_user_id: authenticatedUser.id,
       metricraven_plan: "pro",
     },
   });
   // Return intent.client_secret to the browser as usual.

3. For subscriptions, add it to the subscription

   Stripe creates the invoice's PaymentIntent for you, so put the keys on the subscription. Each invoice payment, including renewals, is then attributed.

   Server

   Copy

   1

   2

   3

   4

   5

   6

   7

   8

   9

   10

   11

   12

   // Subscriptions built with the Payment Element: put the keys on the subscription.
   const subscription = await stripe.subscriptions.create({
     customer: customerId,
     items: [{ price: "YOUR_RECURRING_STRIPE_PRICE_ID" }],
     payment_behavior: "default_incomplete",
     expand: ["latest_invoice.confirmation_secret"],
     metadata: {
       metricraven_visitor_id: visitorId || "",
       metricraven_user_id: authenticatedUser.id,
       metricraven_plan: "pro_monthly",
     },
   });

Metadata keys