Stripe

L’intégration Stripe de Taapit suit automatiquement tous vos paiements Stripe comme des conversions de vente. Installez le SDK, connectez l’app, et passez l’ID de suivi à Stripe.

Comment ça marche

Prérequis

Important : Pour que le suivi des conversions fonctionne, les utilisateurs doivent arriver sur votre site via un deeplink Taapit. C’est ainsi que l’ID de suivi (ta_tid) est généré et transmis à votre site.

Avant de commencer :

Créez un deeplink Taapit pointant vers votre site ou landing page
Activez le suivi des conversions sur votre lien :
- Allez dans les paramètres de votre lien dans le dashboard Taapit
- Activez Suivi des conversions
Configurez l’intégration Stripe dans Paramètres → Conversion et sélectionnez Intégration Stripe

Installation

Installer le SDK Taapit sur votre site

D’abord, ajoutez le SDK Taapit à votre site web pour capturer l’ID de suivi ta_tid :

Package NPM (React/Next.js)
Balise Script (Sans Build)

npm install taapit-sdk

Puis ajoutez le composant Analytics à votre layout racine :

app/layout.tsx

import { Analytics } from 'taapit-sdk/react';

export default function RootLayout({ children }) {
  return (
    <html>
      <body>
        {children}
        <Analytics />
      </body>
    </html>
  );
}

Ajoutez ce script dans votre <head> HTML ou avant </body> :

<script src="https://taap.it/api/sdk"></script>

Cette étape est obligatoire. Sans le SDK, le ta_tid ne sera pas capturé et les conversions ne pourront pas être suivies.

Installer l'app Stripe

Allez sur le Stripe App Marketplace
Recherchez “Taapit Conversion”
Cliquez sur Installer

Ou installez directement depuis votre dashboard Taapit :

Allez dans Paramètres → Intégrations → Stripe
Cliquez sur Installer l’intégration Stripe

Connecter votre workspace Taapit

Après avoir installé l’app dans Stripe :1. Ouvrez l’app Taapit dans votre dashboard Stripe et cliquez sur “Connect workspace”

App Stripe Taapit - Bouton Connect workspace

2. Autorisez la connexion à votre workspace TaapitVous serez redirigé vers la page de consentement Taapit. Sélectionnez le workspace que vous souhaitez connecter et cliquez sur Autoriser.

3. Vérifiez que le workspace est connectéUne fois autorisé, vous verrez votre workspace connecté dans l’app Stripe.

Passer l'ID de suivi à Stripe

Passez le ta_tid à Stripe lors de la création des customers, sessions de checkout ou payment intents.

1. Frontend : Récupérer l’ID de suivi

D’abord, récupérez l’ID de suivi depuis votre frontend pour le passer à votre API :

Avec le SDK Taapit
Avec le Hook React
Depuis le cookie directement

// Utiliser l'objet global taapit (balise script)
const trackingId = taapit.getTrackingId();

import { useTaapitAnalytics } from 'taapit-sdk/react';

function CheckoutButton() {
  const { trackingId } = useTaapitAnalytics();

  const handleCheckout = async () => {
    const response = await fetch('/api/create-checkout', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
        priceId: 'price_xxx',
        trackingId,
      }),
    });
    const { url } = await response.json();
    window.location.href = url;
  };

  return <button onClick={handleCheckout}>S'abonner</button>;
}

L’ID de suivi peut être récupéré depuis :

SDK Taapit - taapit.getTrackingId() ou hook useTaapitAnalytics()
Cookie (ta_tid) - automatiquement défini par le SDK

Le backend devrait vérifier le body et les cookies pour une compatibilité maximale.

2. Tracker les Ventes : Créer une Session de Checkout

Quand un utilisateur effectue un achat, passez l’ID de suivi dans les metadata de la session checkout.

Quand taapitTrackingId est-il requis pour les Checkout Sessions ?

Si le customer a déjà été tracké via un événement lead (avec taapitCustomerExternalId), le taapitTrackingId est optionnel - vous n’avez besoin que du taapitCustomerExternalId pour lier la vente.
Si c’est un nouveau customer (pas de lead préalable), taapitTrackingId est requis pour attribuer la vente.

app/api/create-checkout/route.ts

import { NextRequest } from 'next/server';
import Stripe from 'stripe';

const stripe = new Stripe(process.env.STRIPE_SECRET_KEY!);

export async function POST(request: NextRequest) {
  const body = await request.json();
  const { priceId, customerExternalId } = body;

  // Obtenir l'ID de suivi depuis le cookie OU depuis le body
  // Optionnel si le customer a déjà été tracké via lead
  const trackingId =
    request.cookies.get('ta_tid')?.value ||
    body.trackingId ||
    '';

  const session = await stripe.checkout.sessions.create({
    mode: 'subscription',
    line_items: [{ price: priceId, quantity: 1 }],
    success_url: 'https://votresite.com/success',
    cancel_url: 'https://votresite.com/cancel',
    // Passer l'ID de suivi et l'ID client dans les metadata
    metadata: {
      taapitTrackingId: trackingId, // Optionnel si le customer existe
      taapitCustomerExternalId: customerExternalId, // Requis
    },
    // Aussi dans subscription_data pour les abonnements
    subscription_data: {
      metadata: {
        taapitTrackingId: trackingId,
        taapitCustomerExternalId: customerExternalId,
      },
    },
  });

  return Response.json({ url: session.url });
}

3. (Optionnel) Tracker les Leads : Créer un Customer Stripe

Si vous voulez tracker les leads séparément des ventes, créez un customer Stripe avec l’ID de suivi quand un utilisateur s’inscrit. Taapit écoute le webhook customer.created.

app/api/stripe/create-customer/route.ts

import { NextRequest } from 'next/server';
import Stripe from 'stripe';

const stripe = new Stripe(process.env.STRIPE_SECRET_KEY!);

export async function POST(request: NextRequest) {
  const body = await request.json();
  const { email, name, externalId } = body;

  // Obtenir l'ID de suivi depuis le cookie OU depuis le body
  const trackingId =
    request.cookies.get('ta_tid')?.value ||
    body.trackingId ||
    '';

  // Créer un customer Stripe avec les metadata Taapit
  const customer = await stripe.customers.create({
    email,
    name,
    metadata: {
      taapitTrackingId: trackingId,
      taapitCustomerExternalId: externalId, // Votre ID utilisateur interne
    },
  });

  return Response.json({ customerId: customer.id });
}

Cette étape est optionnelle. Utilisez-la si vous voulez tracker les inscriptions utilisateurs comme des leads avant qu’ils n’effectuent un achat.

4. (Alternative) Utiliser les Stripe Payment Links

Si vous utilisez les Stripe Payment Links, vous pouvez tracker les ventes automatiquement sans écrire de code backend.

Avec les Payment Links, seuls les événements de vente sont trackés. Les webhooks lead ne sont pas créés.

Comment configurer :

Obtenez votre URL Stripe Payment Link (ex: https://buy.stripe.com/xxx)

Ajoutez ?taapit_client_reference_id=1 à l’URL :

https://buy.stripe.com/xxx?taapit_client_reference_id=1

Raccourcissez cette URL avec Taapit

Comment ça marche :Quand un utilisateur clique sur votre deeplink Taapit :

Remplace taapit_client_reference_id=1 par client_reference_id=taapit_tid_{trackingId}
Stripe reçoit l’ID de suivi comme client_reference_id
Quand le checkout est complété, Taapit attribue la vente au clic original

Vérifier la connexion

Allez dans Paramètres → Intégrations → Stripe dans Taapit
Vous devriez voir le statut Connecté
Effectuez un paiement test
Vérifiez l’onglet Analytics pour la conversion

Événements suivis

Événement Stripe	Événement Taapit	Description
`customer.created`	Lead	Customer créé avec les metadata de tracking
`checkout.session.completed`	Vente	Session de checkout complétée
`invoice.paid`	Vente	Facture d’abonnement payée

Champs de metadata

L’intégration recherche ces champs de metadata sur les objets Stripe :

Champ	Requis	Description
`taapitTrackingId`	Voir ci-dessous	L’ID de suivi (`ta_tid` du cookie)
`taapitCustomerExternalId`	Oui	Votre ID utilisateur interne

Utilisez taapitTrackingId (pas ta_tid) dans les metadata Stripe. Le ta_tid est le nom du cookie, tandis que taapitTrackingId est le nom du champ metadata.

Quand taapitTrackingId est-il requis ? - Événements lead (customer.created) : taapitTrackingId est toujours requis - Événements vente (checkout.session.completed, invoice.paid) : - Si le customer a déjà été tracké via un événement lead (avec taapitCustomerExternalId), le taapitTrackingId est optionnel - Si c’est un nouveau customer (pas de lead préalable), taapitTrackingId est requis pour attribuer la vente

Dépannage

Les conversions n'apparaissent pas

Vérifiez les metadata : Assurez-vous que taapitTrackingId est dans vos metadata Stripe 2. Vérifiez la livraison des webhooks : Dans Stripe → Développeurs → Webhooks 3. Vérifiez la connexion : Paramètres → Intégrations → Stripe doit afficher “Connecté”

ID de suivi manquant

Si l’ID de suivi est vide, l’utilisateur : - N’est pas venu d’un lien Taapit

A les cookies bloqués - Le cookie n’a pas été passé au checkout C’est normal pour le trafic direct/organique.

Sécurité

Permission	Objectif
`customer_read`	Lire les informations client
`subscription_read`	Lire les données d’abonnement
`invoice_read`	Lire les montants des factures
`checkout_session_read`	Lire les metadata des sessions checkout
`webhook_read`	Recevoir les événements de paiement

FAQ

Dois-je installer le SDK ?

Oui, vous avez besoin du SDK Taapit sur votre site pour capturer le cookie ta_tid. L’app Stripe ne gère que le suivi des paiements.

Comment sont gérés les renouvellements d'abonnement ?

Chaque événement invoice.paid déclenche une vente. L’ID de suivi du checkout original est utilisé pour l’attribution.

Et les remboursements ?

Actuellement, les remboursements ne sont pas automatiquement suivis. Nous travaillons sur cette fonctionnalité.

Commencer

Conversions

Référence API

Comment ça marche

Prérequis

Installation

1. Frontend : Récupérer l’ID de suivi

2. Tracker les Ventes : Créer une Session de Checkout

3. (Optionnel) Tracker les Leads : Créer un Customer Stripe

4. (Alternative) Utiliser les Stripe Payment Links

Événements suivis

Champs de metadata

Dépannage

Sécurité

FAQ

Prochaines étapes

Intégration Shopify

Intégration manuelle

Commencer

Conversions

Référence API

​Comment ça marche

​Prérequis

​Installation

​1. Frontend : Récupérer l’ID de suivi

​2. Tracker les Ventes : Créer une Session de Checkout

​3. (Optionnel) Tracker les Leads : Créer un Customer Stripe

​4. (Alternative) Utiliser les Stripe Payment Links

​Événements suivis

​Champs de metadata

​Dépannage

​Sécurité

​FAQ

​Prochaines étapes

Intégration Shopify

Intégration manuelle

Comment ça marche

Prérequis

Installation

1. Frontend : Récupérer l’ID de suivi

2. Tracker les Ventes : Créer une Session de Checkout

3. (Optionnel) Tracker les Leads : Créer un Customer Stripe

4. (Alternative) Utiliser les Stripe Payment Links

Événements suivis

Champs de metadata

Dépannage

Sécurité

FAQ

Prochaines étapes