Stripe

TrueMetriks tracks every Stripe payment and sends it back to your ad platforms. The video below walks through the full setup; written steps and screenshots are underneath.

Connect Stripe to TrueMetriks

Video guide

How to connect Stripe to TrueMetriks

The connection has two halves - tell Stripe where to send events (steps 1-7) and paste the signing secret back into TrueMetriks (steps 8-10).

Step 1 - Open Stripe Developers and click Webhooks

Inside the Stripe dashboard, click the Developers button in the bottom-left corner. The Developers menu opens. Click the highlighted Webhooks link.

Workbench
  • Overview
  • Webhooks
  • Events
  • Logs
  • More
Documentation
  • API reference
  • SDKs
  • Stripe.js
  • CLI
  • API keys
  • Created apps
  • Developer settings
Developers
Inside Stripe, click the Developers button in the bottom-left to open the menu, then click the highlighted Webhooks link.

Step 2 - Click Add destination

On the Event destinations page, click the highlighted + Add destination button in the top-right.

Overview Webhooks Events Logs

Event destinations

Send events from Stripe to webhook endpoints and cloud services.

Type Destination Listening to Events from Status
https://demo-brand.example/webhook/stripe 2 events Your account Active
On the Webhooks page, click the highlighted + Add destination button in the top right.

Step 3 - Configure your event destination

Two things on this screen:

  • Event destination scope - pick Your account (highlighted). Connected accounts only applies if you run a Stripe Connect platform.
  • API version - leave it on your current default (2024-12-18.acacia is fine; any current or latest version works).

Configure your event destination

Event destination scope

View docs on event destination scopes

Your account

Events from resources in your account. For Accounts v2, this includes events for accounts created directly within your account.

Connected accounts

Events from resources inside your connected accounts - including their payments, customers, and payment methods.

API version

2024-12-18.acacia
Pick Your account (highlighted) and leave the API version on your current default - 2024-12-18.acacia works.

Step 4 - Select the two events TrueMetriks listens for

Scroll down to the Events section. Search and check both of these:

  • checkout.session.completed - one-time Stripe Checkout payments + the first payment of any subscription started via Checkout.
  • invoice.payment_succeeded - every recurring subscription renewal + every manually-sent invoice (e.g. you invoice a buyer after a discovery call).

Together these two cover every successful payment. Do not subscribe to charge.succeeded (it overlaps with both events above and would double-count).

Events

All events Selected events 2

checkout.session.completed

Occurs when a Checkout Session has been successfully completed.

invoice.payment_succeeded

Occurs whenever an invoice payment attempt succeeds.

Search the event list and check both checkout.session.completed and invoice.payment_succeeded. The counter shows 2 selected - click Continue.

The Selected events counter should show 2. Click Continue.

Step 5 - Pick Webhook endpoint as the destination type

Stripe asks where to send the events. Pick the highlighted Webhook endpoint tile, then click Continue.

Choose where you want to send events

Stripe can send events to a webhook endpoint, Amazon EventBridge, or Azure Event Grid.

Destination type

Webhook endpoint

Send webhook events to a hosted endpoint.

Amazon EventBridge

Send events to your AWS account.

Azure Event Grid

Send events to your Azure account.

Pick the highlighted Webhook endpoint tile, then click Continue.

Step 6 - Copy the webhook URL from TrueMetriks

Open TrueMetriks in another tab. Go to Settings > Integrations and click the highlighted Stripe tile.

Integrations

Connect third-party data sources to fire events into TrueMetriks.

Typeform

Typeform

Connected

Calendly

Calendly

Connected

Microsoft Clarity

Configured (1 project)

stripe

Stripe

Not connected

Whop

Not connected

In TrueMetriks, open Settings → Integrations and click the highlighted Stripe tile.

On the Stripe page, click the highlighted Copy button next to the Your webhook URL field. The URL looks like https://q.<your-domain>/w/stripe.

Stripe Not connected

Fire offline conversions when a Stripe payment completes. Paste your webhook signing secret from Stripe and add the URL below as a webhook endpoint in your Stripe dashboard.

Your webhook URL

https://q.demo-brand.example/w/stripe

Webhook signing secret

whsec_...
Click the highlighted Copy button to copy your Stripe webhook URL, then paste it into Stripe's Endpoint URL field.

Step 7 - Paste the URL into Stripe and create the destination

Back in Stripe, fill in the Configure destination form:

  • Destination name - anything that helps you recognise it later. "TM Purchase" works.
  • Endpoint URL - paste the URL you just copied from TrueMetriks.

Click the highlighted Create destination button.

Configure destination

Tell Stripe where to send events and give your destination a helpful description.

Events fromYour account
Payload styleSnapshot
API version2024-12-18.acacia
Listening to2 events

Destination name

11/100 characters

TM Purchase

Endpoint URL

Webhooks require a URL to send events to.

https://q.demo-brand.example/w/stripe
Give the destination a name (anything works - "TM Purchase" here), paste the webhook URL from TrueMetriks into Endpoint URL, then click Create destination.

Step 8 - Copy the signing secret

Stripe creates the destination and lands you on the Destination details page. Scroll to the Signing secret card. Click the highlighted copy icon to copy the whsec_... value.

Destination details

Destination IDwe_1Td6H6AOj9Env1iKBn6psm4D
NameTM Purchase
Endpoint URLhttps://q.demo-brand.example/w/stripe
API version2024-12-18.acacia
Listening to2 events

Signing secret

Use this secret to verify that events come from Stripe. You can always view or roll this secret from the destination details page.

whsec_0rh82cjDByeoaxMNOjs2thMltZh1kQTv
Stripe now shows the Signing secret. Click the highlighted copy icon to copy the whsec_... value - you will paste it back in TrueMetriks.

Step 9 - Paste the signing secret in TrueMetriks and click Connect Stripe

Switch back to the TrueMetriks Stripe page. Paste the whsec_... value into the Webhook signing secret field, then click the highlighted Connect Stripe button.

Stripe Not connected

Fire offline conversions when a Stripe payment completes. Paste your webhook signing secret from Stripe and add the URL below as a webhook endpoint in your Stripe dashboard.

Your webhook URL

https://q.demo-brand.example/w/stripe

Webhook signing secret

•••••••••••••••••••••••••••••••••••••
Paste the whsec_... signing secret from Stripe, then click the highlighted Connect Stripe button.

Step 10 - Connected

The page flips to the connected state, showing a green Connected pill and the date you connected. That is the setup done.

Stripe Connected since 31/05/2026

Fire offline conversions when a Stripe payment completes. Paste your webhook signing secret from Stripe and add the URL below as a webhook endpoint in your Stripe dashboard.

Your webhook URL

https://q.demo-brand.example/w/stripe
Stripe is now connected. Every checkout.session.completed and invoice.payment_succeeded webhook fires a Purchase event into TrueMetriks.

Verify

Trigger a payment in Stripe and the matching Purchase event shows up in the TrueMetriks dashboard within a few seconds. If the customer's journey is connected to an ad, that Purchase also lands in your connected ad platforms: Facebook CAPI, Google Ads, GA4, TikTok.

Frequently asked questions

Which Stripe events should I subscribe to?

Just two: checkout.session.completed and invoice.payment_succeeded. Together they cover every successful payment. Do not add charge.succeeded, since it overlaps and would double-count.

Will a new subscription's first payment count twice?

No. Stripe fires both events for the first payment, but TrueMetriks fires Purchase only once per payment and skips the duplicate. Renewals and manually-sent invoices fire normally.

Does the Stripe revenue reach my ad platforms?

Yes. If the customer's journey is connected to an ad, TrueMetriks forwards the Purchase to every connected platform: Facebook CAPI, Google Ads, GA4, and TikTok.

Need help with this?

Reach us instantly on WhatsApp, or send us a message and we will get back to you. On workdays we usually respond in less than 24 hours.

or send us a message