Skip to main content
Request a demo
  1. Home
  2. Connectors
  3. Stripe - TikTok Events API
Stripe TikTok Events API

Send events from your Stripe-billed app to the TikTok Events API

Each event is resolved to a person against a 750M+ device graph before it reaches the TikTok Events API, with restored click IDs, deduplicated conversions and delivery you can audit.

Request a demo Start free trial
US device IDs in the graph
750M+
Match rate on events
90%+
Identity window, per customer
Lifetime
Most brands are live
<20 min

How it flows

How a Stripe event reaches the TikTok Events API. Sent from your app, resolved to a person, then forwarded.

01 Capture

Captured from Stripe

For apps that bill through Stripe, send payment and subscription events to Upstack with the Upstack Pixel and JavaScript SDK, resolved to a customer before they reach the tools you spend on.

See the Stripe integration
StripeWhat it sends
  • subscription_initial_purchaseyou fire it for the first subscription order
  • subscription_recurring_purchaseon invoice.paid for an existing subscription
  • payment_succeededmaps to invoice.paid or charge.succeeded
  • payment_refundedmaps to charge.refunded
  • amount / currencyamount in cents, with invoiceId and subscriptionId

02 Understand

Resolved to one person before it leaves

Every Stripe event is matched against a 750M+ device graph, so a phone browse and a desktop checkout resolve to one customer rather than two strangers.

How resolution works
Upstack DataResolved before it is sent
  • IdentityMatched against a 750M+ device graph, so a phone browse and a desktop checkout resolve to one customer.
  • customer_typeNew or returning, resolved before send.
  • DeduplicationBrowser and server copies of the same purchase collapse on event ID, so nothing is counted twice.
  • Bot and fraud filteringAutomated traffic never reaches the model, because what you keep out of the training set matters as much as what goes in.

Ad platforms accept almost anything and tell you very little. These controls exist so you can see what was sent and what was accepted, rather than inferring it from a reporting gap.

03 Activate

Delivered to the TikTok Events API

Forward resolved conversions to the TikTok Events API so the algorithm optimizes on customers, not sessions.

See the TikTok Events API integration
TikTok Events APIWhat it receives
  • email / phone (hashed)Events API matching
  • ttclid / ttpattribute the click
  • event_idbrowser and server dedupe
  • value / currencyoptimize on revenue

Which events reach the TikTok Events API

Each Upstack event is mapped to the TikTok Events API event below before it is sent.

Upstack eventSent to TikTok Events API asKey data on the event
Page viewPageviewurl, referrer
Product viewViewContentcontent_id, content_type, value, currency
Add to cartAddToCartcontent_id, content_type, value, currency
CheckoutInitiateCheckoutvalue, currency, quantity
PurchasePurchasecontent_id, value, currency, order_id

Every event carries email, phone and external_id when available, hashed with SHA-256 as the Events API requires, plus the ttclid click ID captured by the Upstack Pixel for deterministic matching.

The catch

A retried payment produces several Stripe objects for one purchase.

Forwarding each as a conversion inflates reported performance by the retry rate, which is highest on exactly the campaigns bringing in the least reliable payment methods. Fire the Upstack event when Stripe reports the payment succeeded (invoice.paid or charge.succeeded), so only the settled payment becomes a conversion.

Where to check in the TikTok Events APIDelivery you can audit

TikTok Events Manager Test Events

then the event's match rate once live traffic is flowing.

What changes

What changes when Stripe feeds the TikTok Events API. Two gains on the TikTok Events API side, two on the Stripe side.

TikTok Events API

Server-side delivery

By default Upstack sends events to TikTok from its servers as well as through the TikTok tag, so an event an ad blocker or browser privacy setting stops in the browser still arrives from the server.

TikTok Events API

Identity-resolved events

Events sent to TikTok carry the resolved customer whenever Upstack can identify one, matched against a 750M+ device graph.

Stripe

Subscription purchases as events

Fire subscription_initial_purchase for the first order and subscription_recurring_purchase each time a renewal is paid, so first orders and renewals are reported separately.

Stripe

Payments and refunds

payment_succeeded, payment_failed and payment_refunded each map to a Stripe event (invoice.paid or charge.succeeded, invoice.payment_failed, charge.refunded), so money events reach Upstack when your app fires them.

Setup

Live in under 20 minutes.

You need admin access to your TikTok Business Center.

Upstack dashboardExample
TikTok Events API Destination Healthy
Read the full TikTok Events API setup guide

  1. 01

    Install the Upstack Pixel and SDK

    Add the Upstack Pixel to your app, then fire the subscription and payment events with the JavaScript SDK when Stripe reports them, such as subscription_recurring_purchase when invoice.paid fires for an existing subscription.

  2. 02

    Add the TikTok destination

    Under Destinations, add TikTok with your Pixel ID (a 20 character alphanumeric string, also called the Dataset ID) and an Events API access token generated in TikTok Events Manager, which is shown only once.

  3. 03

    Check Browser and Server events

    Upstack marks the destination Healthy, and TikTok Events Manager shows events arriving via both Browser and Server (CAPI), with a test order’s Purchase event appearing within a few minutes. “Update Recommended” warnings in Events Manager are normal and need no action.

FAQ

Questions about Stripe and the TikTok Events API.

Will I see duplicate conversions if I run both the TikTok Pixel and the Events API?

No, as long as the Pixel ID in Upstack matches the TikTok Pixel firing in your storefront. Upstack sends a shared event_id on every server-side event and TikTok keeps only one copy. If you see duplicates, the Pixel IDs almost always differ.

Which events does the TikTok Events API receive?

PageView as Pageview, ViewContent as ViewContent, AddToCart as AddToCart, InitiateCheckout as InitiateCheckout and Purchase as Purchase.

Which customer parameters are sent to the TikTok Events API?

Every event carries email, phone and external_id when available, hashed with SHA-256 as the Events API requires, plus the ttclid click ID captured by the Upstack Pixel for deterministic matching.

How do I check that Stripe events are reaching the TikTok Events API?

Upstack marks the destination Healthy, and TikTok Events Manager shows events arriving via both Browser and Server (CAPI), with a test order’s Purchase event appearing within a few minutes. “Update Recommended” warnings in Events Manager are normal and need no action.

How long does it take to connect Stripe to the TikTok Events API?

Most brands are live in under 20 minutes. Once Stripe events reach Upstack, every destination receives the same resolved events, the TikTok Events API included.

Related connectors

See all 408 connectors

Stripe to

All 34 Stripe connectors

TikTok Events API from

TikTok Events API integration

Get Stripe talking to TikTok Events API.

A 15-minute walkthrough of this connector on your own account.

Request a demo Start free trial

21-day free trial, no card. Month to month.