Comment intégrer Stripe pour le suivi des revenus ?

Connecter Stripe permet à Zenovay d'afficher les revenus aux côtés de vos données de trafic — quelle source marketing a produit le client payant, sur quelle page il a converti, quelle campagne a conclu l'affaire.

La configuration se fait par site, à l'intérieur du tableau de bord de ce site. Il y a un seul identifiant à coller — une clé API Stripe restreinte — et Zenovay gère le reste du câblage du webhook pour vous.

Connecter Stripe

1. 1

   Ouvrir les paramètres Revenue du site

   Dans app.zenovay.com, ouvrez le site que vous souhaitez connecter, allez à ses Paramètres, et ouvrez l'onglet Revenue. Chaque connexion Stripe est mappée à un site Zenovay.

2. 2

   Choisir Stripe

   Cliquez sur la carte Stripe. Vous verrez un court formulaire de configuration.

3. 3

   Créer et coller une clé API restreinte

   Zenovay crée un lien direct vers l'écran « Créer une clé restreinte » de Stripe avec les autorisations de lecture qu'il nécessite (solde, frais, abonnements, clients, intentions de paiement, sessions de paiement, factures) ainsi que l'écriture de webhook. Créez la clé dans Stripe, copiez-la (elle commence par rk_live_… ou rk_test_…), collez-la dans le champ et cliquez sur Connecter.

4. 4

   Laisser Zenovay terminer la configuration

   Lorsque vous enregistrez la clé, Zenovay la valide auprès de Stripe et crée automatiquement le point d'extrémité du webhook sur votre compte Stripe, afin que les paiements arrivent sans que vous touchiez au tableau de bord Stripe. La carte affiche Connecté avec un badge vert « identifiants vérifiés » une fois que c'est fait.

Une fois connecté, l'onglet Revenue de votre tableau de bord affiche les graphiques de MRR, ARR, revenus par visiteur et revenus par source. Les revenus sont capturés à partir du moment de la connexion — Zenovay enregistre les paiements lorsque Stripe envoie les événements du webhook, il n'effectue pas une réimportation rétroactive de l'historique Stripe.

Configurer le webhook manuellement (optional)

Zenovay crée le webhook Stripe pour vous, donc la plupart des gens n'en ont jamais besoin. Si vous préférez câbler le webhook vous-même — par exemple parce que votre clé Stripe ne contient pas l'autorisation d'écriture de webhook — vous pouvez pointer Stripe vers le récepteur Zenovay et coller le secret de signature en retour.

1. Dans le tableau de bord Stripe, allez à Developers → Webhooks → Add endpoint.
2. URL du point d'extrémité : https://api.zenovay.com/api/webhooks/stripe/YOUR_WEBSITE_ID (votre ID de site se trouve dans l'URL de la page du tableau de bord du site).
3. Sélectionnez ces événements :
   • checkout.session.completed
   • payment_intent.succeeded
   • invoice.paid
   • customer.subscription.created
   • customer.subscription.updated
   • customer.subscription.deleted
4. Enregistrez, puis copiez le secret de signature du point d'extrémité (commence par whsec_…).
5. De retour dans le formulaire Stripe de Zenovay (l'onglet des paramètres Revenue), collez le secret de signature afin que Zenovay puisse vérifier les événements entrants.

Attribuer un paiement à un visiteur

Pour que l'attribution paiement-à-source-de-trafic fonctionne, l'ID anonyme Zenovay du visiteur doit parvenir au dossier Stripe. La façon la plus simple est de le définir comme client_reference_id de la session de paiement, ou de le joindre en tant que métadonnées au paiement :

// Sur votre serveur de paiement
const visitorId = req.cookies['zv_visitor_id'] // ou comment votre client le transmet
stripe.checkout.sessions.create({
  // ...
  client_reference_id: visitorId,
  metadata: { zenovay_visitor_id: visitorId }
})

Lorsque le paiement se termine, le gestionnaire de webhooks de Zenovay lit le client_reference_id (ou metadata.zenovay_visitor_id / metadata.visitor_id) et joint le paiement à la session du visiteur — y compris la source, la campagne et les pages qu'il a visitées avant de payer. Les paiements sans ID de visiteur sont toujours enregistrés comme des revenus, juste sans attribution de source.

Quels modèles d'attribution sont disponibles

Zenovay calcule plusieurs modèles d'attribution afin que vous puissiez voir comment le crédit change en fonction des points de contact que vous pondérez :

• Last Touch — le crédit va à la source de la session où le paiement a eu lieu.
• First Touch — le crédit va à la source d'où le visiteur est arrivé pour la première fois.
• Linear — le crédit est divisé équitablement entre tous les points de contact du chemin.
• Position-Based — pèse les points de contact d'arrivée et de sortie plus fortement.
• Time-Decay — les points de contact plus proches de la conversion obtiennent plus de crédit.

Basculez entre eux dans l'onglet Revenue pour voir comment chaque modèle attribue le crédit.

Déconnexion

Ouvrez la carte Stripe dans l'onglet des paramètres Revenue du site et cliquez sur Supprimer. Par défaut, cela déconnecte simplement les identifiants — vos enregistrements de paiement existants restent dans le tableau de bord pendant la durée de votre fenêtre de conservation des données. Si vous souhaitez également supprimer les données de revenus historiques, cochez l'option de suppression en cascade dans la boîte de dialogue de confirmation (elle vous montre exactement combien d'enregistrements seront supprimés).

La suppression de l'intégration dans Zenovay ne supprime pas le webhook du côté Stripe, vous souhaiterez donc peut-être également supprimer le point d'extrémité dans votre tableau de bord Stripe.

Lectures complémentaires

• Vue d'ensemble des webhooks
• Suivi des revenus e-commerce
• Vue d'ensemble de l'API
• Installer le script de suivi