Metrivo
Docs/Stripe Setup

Stripe Setup

Connect Stripe through guided webhook setup. Successful charges are matched to Metrivo visitor and session signals for confidence-based revenue attribution.

How the integration works

Metrivo receives webhook events from your Stripe account. When a checkout.session.completed or invoice.paid event fires, Metrivo extracts the customer email, visitor ID, and session ID when present, then attributes the revenue with a confidence label.

We never charge your customers or access your Stripe funds. The integration is read-only for webhook events only.

Setup steps

1

Go to Stripe integration page

For private launch, contact Metrivo support to create the Stripe payment integration row for your website.

2

Create a Stripe webhook

Add the generated Metrivo integration webhook URL in Stripe and subscribe to checkout.session.completed, payment_intent.succeeded, and invoice.paid events.

3

Store the webhook secret

Share the webhook signing secret through the concierge setup path so Metrivo can verify events for this website.

4

Send Metrivo metadata

Add metrivo_visitor_id and metrivo_session_id to checkout metadata when available.

5

Test the connection

Make a test payment or use Stripe test mode. Metrivo support confirms the webhook was received and the payment appears with an attribution confidence label.

Events tracked

checkout.session.completed

One-time payments via Stripe Checkout. Revenue is attributed to the visitor session.

invoice.paid

Subscription invoice payments. Works for recurring subscriptions, metered billing, and invoicing.

charge.refunded

Refunds are automatically deducted from your revenue attribution data to maintain accuracy.

Manual webhook setup (alternative)

For private launch, Stripe setup is manual:

  1. Ask Metrivo support to create the Stripe payment integration and webhook URL.
  2. In your Stripe Dashboard, go to Developers → Webhooks → Add endpoint.
  3. Paste the Metrivo webhook URL.
  4. Select events to listen for: checkout.session.completed, invoice.paid, charge.refunded.
  5. Share the signing secret through the concierge setup path so it can be stored on the integration config.

Using a different payment provider?

Metrivo also supports Razorpay, Dodo Payments, and the Manual Payment API for Paddle, Lemon Squeezy, Gumroad, or any custom payment system.