Comment suivre les ventes Stripe d'un affilié ?

Ce que Stripe sait, et ce qu'il ignore

Stripe enregistre des paiements. Il ne connaît ni vos affiliés, ni leurs liens. Pour attribuer une vente, il faut donc un identifiant qui voyage du clic jusqu'au paiement.

Stripe documente une première réponse. Si vous ajoutez le paramètre client_reference_id à un lien de paiement, il est renvoyé dans le webhook checkout.session.completed une fois le paiement terminé. Il accepte des caractères alphanumériques, des tirets et des tirets bas, jusqu'à 200 caractères. Un identifiant d'affilié y trouve sa place.

Stripe documente aussi les métadonnées. Quand il envoie un événement à votre endpoint webhook, il inclut l'objet concerné et les métadonnées qu'il contient. Un identifiant d'affilié stocké ainsi peut être relu côté serveur pour calculer les commissions.

Ces deux mécanismes demandent du développement. Si vous ne voulez pas en écrire, un connecteur s'en charge.

Ce que couvre le connecteur Stripe de Business-Affiliation

Le connecteur lit tous les paiements encaissés sur votre compte Stripe. Cela inclut les liens de paiement, les pages Stripe Checkout, les abonnements avec leurs renouvellements, et les remboursements. Les outils qui encaissent sur votre propre compte Stripe y apparaissent aussi.

La mise en place suit quatre étapes.

1. Dans Stripe, ouvrez Workbench, onglet Webhooks, puis « Créer une destination d'événements ».
2. Choisissez « Votre compte », puis les événements charge.succeeded, charge.refunded, invoice.paid et checkout.session.completed.
3. Choisissez « Endpoint de webhook » et collez l'adresse affichée dans l'onglet Suivi des ventes, partie Stripe.
4. Cliquez sur « Révéler la clé secrète », copiez la clé qui commence par whsec_ et collez-la dans l'onglet.

Chaque envoi de Stripe est vérifié avec cette clé. Un envoi qui ne vient pas de votre compte est refusé. Le mode test et le mode réel ont chacun leur clé : prenez celle du mode dans lequel vous vendez.

Comment la vente trouve son affilié

Le cas courant est l'attribution par email. L'affilié partage son lien. Le visiteur arrive sur votre page de capture ou de vente, où le script repère l'email saisi dans le formulaire et le rattache à l'affilié. Quand Stripe transmet le paiement, la vente revient à l'affilié dont le lead correspond à l'email du client.

Ce rattachement tient dans la durée. Une vente faite des semaines plus tard revient bien à l'affilié qui a amené l'inscription. Il en va de même sur un autre appareil ou depuis un email de relance. Gardez donc le script sur vos pages de capture et de vente, sinon les inscriptions ne sont pas enregistrées.

Si vous créez vous-même vos sessions Stripe Checkout par programmation, il existe un chemin direct. Transmettez le code de l'affilié dans le champ client_reference_id : la vente lui est attribuée sans passer par l'email. Sur une page où le script est installé, ce code se lit avec BusinessAffiliation.ref().

Mon avis est net : partez de l'email. C'est la méthode qui demande le moins de travail et qui résiste le mieux aux changements d'appareil. Réservez client_reference_id aux flux de paiement que vous maîtrisez entièrement.

Abonnements, remboursements et TVA

Les renouvellements d'abonnement sont commissionnés si votre programme prévoit une commission récurrente. Sans cette case cochée, un paiement qui se répète n'est commissionné qu'une fois. Décidez-le avant de recruter, pour l'annoncer clairement dans votre offre.

Un remboursement complet retire la vente. Un remboursement partiel est signalé dans le journal, et c'est à vous de l'ajuster dans l'onglet Ventes. Pensez-y : la commission n'est due qu'après la période de remboursement. Une vente remboursée ne donne aucune commission.

La commission est calculée sur le montant hors taxes. Indiquez votre taux de TVA dans la carte « Montants et TVA » de l'onglet Suivi des ventes. L'outil retrouve ainsi le hors taxes quand il reçoit un montant toutes taxes comprises. Indiquez 0 si vous ne facturez pas de TVA. Informations générales, pas un conseil personnalisé : votre comptable reste juge du bon taux.

L'erreur à éviter : deux canaux pour une vente

Systeme.io, ClickFunnels ou une extension WordPress peuvent encaisser sur votre compte Stripe. Si vous branchez leur connecteur et celui de Stripe, le même paiement arrive par deux portes. Le guide précise que chaque paiement reçu par les deux canaux est relié à une seule vente. Les upsells du même montant ne sont pas bloqués pour autant.

Le plus simple reste de choisir un seul canal par vente. Certains outils encaissent sur leur propre compte Stripe et non sur le vôtre. Faites alors un achat test pour vérifier que Stripe transmet bien le paiement.

Le journal « Derniers événements reçus » donne le verdict de chaque envoi : vente enregistrée, non attribuée, doublon ou signature refusée. Consultez-le après chaque test, puis après vos premières vraies ventes.

L'avis de terrain

Mon conseil tient en un geste : faites un achat test en mode test avant d'ouvrir le programme aux affiliés. Relisez ensuite le journal « Derniers événements reçus » pour vérifier que la vente est enregistrée et attribuée. Si le verdict est « non attribuée » ou « signature refusée », corrigez-le avant de recruter.

Le point de vue contraire

Certains vendeurs préfèrent ne pas ouvrir de webhook vers un tiers et passer par une application installée dans Stripe. Rewardful, par exemple, permet de voir depuis le tableau de bord Stripe quels clients ont été parrainés, ainsi que l'affilié, la campagne et le détail des commissions. L'application ajuste aussi les commissions en cas de remboursement, d'annulation, de période d'essai ou de changement d'abonnement.

L'argument est sérieux : tout reste dans l'interface que vous consultez déjà, et le calcul est automatisé. Le prix à payer, c'est un outil de plus à installer et à administrer, avec ses propres réglages.

L'attribution par email a aussi une limite. Si un client s'inscrit avec une adresse et paie avec une autre, le lien se perd. La déclaration de vente par l'affilié et l'import d'un fichier servent alors de filet. À vous de trancher : un suivi relié à une plateforme d'affiliation, ou un suivi qui reste dans Stripe.

Ce que ça change pour vous

Questions fréquentes

Notions de l'encyclopédie