Intégration d'affiliation RevenueCat : le guide complet.

Pourquoi le webhook est la source de vérité

Un programme d'affiliation paie de l'argent réel : le déclencheur de la commission doit donc être quelque chose que ni l'appareil client ni le créateur ne peuvent falsifier. Le webhook RevenueCat a exactement les bonnes propriétés :

• Il est de serveur à serveur. Les événements naissent dans le backend de RevenueCat après qu'il a validé la transaction sous-jacente du store. Rien dans le binaire de votre app ne peut en forger un.

• Il couvre déjà les deux stores. Un seul webhook transporte les événements d'abonnement iOS et Android dans un même format : la couche d'affiliation se moque de savoir de quel store vient le reçu.

• Il transporte les subscriber attributes. C'est le pivot de toute l'intégration : des paires clé-valeur arbitraires définies sur un utilisateur voyagent avec chaque événement le concernant.

Sur InfluTo, c'est l'un des deux chemins de vérification pris en charge — l'autre étant la validation directe App Store Server API / Google Play pour les apps sans RevenueCat. Vous en choisissez exactement un par app, jamais les deux : deux sources de vérité pour le même argent, c'est ainsi que naissent les bugs de double comptage.

Comment l'attribution voyage sur le webhook

Pas à pas, à travers la vie d'un utilisateur parrainé :

1. 1

   Le code atteint le SDK. Un créateur partage son code. L'utilisateur installe votre app et le code atteint le SDK — saisi à la main, ou transporté par le lien de parrainage.

2. 2

   Le SDK marque l'utilisateur dans RevenueCat. Le SDK InfluTo l'écrit comme subscriber attribute influto_code dans RevenueCat. À partir de là, l'identité du créateur voyage avec l'utilisateur à l'intérieur même de RevenueCat. Les clics sur le lien du créateur ont déjà été dédupliqués et signalés anti-fraude côté InfluTo ; la correspondance du code, elle, est déterministe — sans fingerprinting, sans IDFA, sans invite ATT.

3. 3

   Le webhook part ; la conversion est créée. Quand l'utilisateur s'abonne, RevenueCat valide la transaction du store et déclenche le webhook. InfluTo lit influto_code sur l'événement, rapproche le créateur et crée la conversion.

Les trois événements qui comptent

• INITIAL_PURCHASE. La première transaction d'abonnement de l'utilisateur. Elle crée la conversion et verrouille le taux de commission : le taux au démarrage de l'abonnement vaut pour toute la vie de cet abonné, si bien que les changements de taux en cours de campagne ne re-tarifent jamais silencieusement les abonnés existants d'un créateur. Un détail critique : vérifiez le period type de l'événement. Un démarrage d'essai arrive aussi en INITIAL_PURCHASE, et un essai n'est pas un revenu — aucune commission ne se cumule dessus.

• RENEWAL. Le moteur du récurrent. Chaque événement de renouvellement ajoute un cumul de commission au créateur rapproché. C'est aussi là qu'un utilisateur en essai devient commissionnable : quand l'essai se convertit en payant, la transaction payante apparaît et la commission démarre. La règle qui garde tout honnête est simple — la commission suit l'argent vérifié : les créateurs gagnent donc sur les conversions d'essai, jamais sur les démarrages d'essai. Cela signifie aussi que les créateurs ne peuvent pas farmer de commission avec des inscriptions d'essai jetables, ce qui protège votre séquestre et vos données.

• CANCELLATION. Le mécanisme d'honnêteté. Renouvellement automatique désactivé, les renouvellements cessent d'arriver, et le cumul s'arrête avec eux. Un remboursement signifie que des revenus sur lesquels une commission vous a été facturée ont été annulés — c'est pourquoi InfluTo retient la commission pendant la fenêtre de remboursement avant qu'elle ne devienne payable. Grâce à la retenue, un abonnement remboursé n'est tout simplement jamais versé ; vous ne courez pas après un créateur pour de l'argent déjà parti. (Les événements d'expiration ferment la boucle quand l'accès prend réellement fin.)

La configuration, en quatre étapes

1. 1

   Installez le SDK et définissez l'attribut. Swift, Kotlin, Flutter ou React Native/Expo — open source sur github.com/influto, environ 5 minutes. Le SDK se charge d'écrire influto_code ; vous lui passez simplement le code avec lequel l'utilisateur est arrivé. Les extraits exacts par plateforme : docs.influ.to/integrations/revenuecat.

2. 2

   Ajoutez le webhook dans RevenueCat. Dans le tableau de bord RevenueCat, ajoutez InfluTo comme intégration webhook avec votre URL d'endpoint et votre en-tête d'autorisation. RevenueCat prend en charge plusieurs intégrations webhook par projet : vos webhooks existants continuent de fonctionner tels quels. Traitez l'en-tête d'auth comme un secret ; InfluTo rejette les événements non authentifiés, et vous pouvez renouveler le secret en cas de fuite.

3. 3

   Testez en sandbox. RevenueCat marque chaque événement avec son environnement : les achats sandbox se distinguent donc des achats de production. Lancez votre app avec un compte store sandbox, appliquez un code de parrainage de test, complétez un abonnement sandbox et regardez la conversion attribuée apparaître. Si vous avez connecté un agent IA via MCP, influto_integration_status rapporte exactement ce que la plateforme a vu — activité SDK, événements webhook, conversions de test attribuées — et influto_test_integration exécute le contrôle en direct. Ne sautez pas cette étape : un programme silencieusement cassé le jour du lancement brûle une confiance des créateurs que vous ne récupérerez pas.

4. 4

   Passez en production. Approvisionnez le portefeuille sous séquestre (remboursable, via Stripe), créez la campagne, invitez des créateurs. À partir de là, le pipeline est autonome : les événements arrivent, la commission se cumule, Stripe Connect paie les créateurs depuis le portefeuille avec un minimum de 1 $. Configuration gratuite, 10 % de commission de plateforme sur les commissions.

claude mcp add --transport http influto https://influ.to/mcp

Ce que vous n'avez pas à changer

Rien ne bouge dans votre configuration RevenueCat existante. Entitlements, offerings, paywalls, vos webhooks actuels et votre analytique — tout reste intact. RevenueCat reste votre source de vérité des revenus ; la couche d'affiliation, c'est un subscriber attribute plus un consommateur de webhook supplémentaire. Si vous la retirez un jour, vous supprimez l'intégration webhook et les écritures d'attribut, et votre pile d'abonnements est exactement comme avant. Le résumé plus court, côté produit, vit sur la page fonctionnalité de l'intégration RevenueCat, en lien ci-dessous — et vous pouvez la configurer gratuitement dès aujourd'hui.