RevenueCat-Affiliate-Integration: der komplette Guide.

Warum der Webhook die Quelle der Wahrheit ist

Ein Affiliate-Programm zahlt echtes Geld — der Auslöser für Provision muss also etwas sein, das weder das Client-Gerät noch der Creator fälschen kann. Der RevenueCat-Webhook hat genau die richtigen Eigenschaften:

• Er ist Server-to-Server. Events entstehen im RevenueCat-Backend, nachdem es die zugrunde liegende Store-Transaktion validiert hat. Nichts in deiner App-Binary kann eines fälschen.

• Er deckt schon beide Stores ab. Ein Webhook trägt iOS- und Android-Abo-Events in einem Format — der Affiliate-Schicht ist egal, aus welchem Store der Beleg kam.

• Er trägt Subscriber-Attribute. Das ist das Scharnier der ganzen Integration: beliebige Schlüssel-Wert-Paare, die du auf einen Nutzer setzt, reisen mit jedem Event über diesen Nutzer mit.

Bei InfluTo ist das einer von zwei unterstützten Verifizierungswegen — der andere ist die direkte App-Store-Server-API-/Google-Play-Belegvalidierung für Apps ohne RevenueCat. Du wählst genau einen pro App, nie beide: Zwei Quellen der Wahrheit fürs selbe Geld — so entstehen Doppelzählungs-Bugs.

Wie die Attribution auf dem Webhook mitfährt

Schritt für Schritt durch das Leben eines geworbenen Nutzers:

1. 1

   Der Code erreicht das SDK. Ein Creator teilt seinen Code. Der Nutzer installiert deine App, und der Code erreicht das SDK — eingetippt oder vom Empfehlungslink mitgebracht.

2. 2

   Das SDK markiert den Nutzer in RevenueCat. Das InfluTo-SDK schreibt ihn als Subscriber-Attribut influto_code in RevenueCat. Ab jetzt reist die Identität des Creators mit dem Nutzer innerhalb von RevenueCat selbst. Klicks auf den Link des Creators wurden auf InfluTo-Seite schon dedupliziert und auf Betrug markiert; der Code-Match aber ist deterministisch — kein Fingerprinting, kein IDFA, kein ATT-Prompt.

3. 3

   Der Webhook feuert; die Conversion entsteht. Abonniert der Nutzer, validiert RevenueCat die Store-Transaktion und feuert den Webhook. InfluTo liest influto_code aus dem Event, matcht den Creator und erstellt die Conversion.

Die drei Events, auf die es ankommt

• INITIAL_PURCHASE. Die erste Abo-Transaktion des Nutzers. Sie erstellt die Conversion und schreibt den Provisionssatz fest: Der Satz beim Abo-Start gilt für die gesamte Lebenszeit dieses Abonnenten — Satzänderungen mitten in der Kampagne bepreisen die bestehenden Abonnenten eines Creators also nie stillschweigend um. Ein kritisches Detail: Prüf den Period Type des Events. Ein Trial-Start kommt ebenfalls als INITIAL_PURCHASE — und ein Trial ist kein Umsatz, darauf entsteht keine Provision.

• RENEWAL. Der wiederkehrende Motor. Jedes Verlängerungs-Event fügt dem gematchten Creator eine Provisionsgutschrift hinzu. Hier wird auch ein Trial-Nutzer provisionsfähig: Konvertiert der Trial zu bezahlt, taucht die bezahlte Transaktion auf und die Provision beginnt. Die Regel, die alles ehrlich hält, ist simpel — Provision folgt verifiziertem Geld. Creator verdienen also an Trial-Conversions, nie an Trial-Starts. Das heißt auch: Creator können keine Provision farmen, indem sie Wegwerf-Trial-Anmeldungen treiben — das schützt dein Budget und deine Daten.

• CANCELLATION. Der Ehrlichkeitsmechanismus. Ist die automatische Verlängerung aus, kommen keine Renewals mehr — und die Gutschrift stoppt mit ihnen. Eine Erstattung heißt: Geld, auf das Provision berechnet wurde, ist zurückgeflossen — deshalb hält InfluTo Provision bis zum Ende des Erstattungsfensters, bevor sie auszahlbar wird. Durch die Sperrfrist wird ein erstattetes Abo schlicht nie ausgezahlt; du jagst keinem Creator hinterher, damit er Geld zurückgibt, das schon weg ist. (Expiration-Events schließen den Kreis, wenn der Zugang wirklich endet.)

Setup in vier Schritten

1. 1

   SDK installieren und Attribut setzen. Swift, Kotlin, Flutter oder React Native/Expo — open source auf github.com/influto, etwa 5 Minuten. Das Schreiben von influto_code übernimmt das SDK; du übergibst ihm nur den Code, mit dem der Nutzer kam. Exakte Snippets pro Plattform: docs.influ.to/integrations/revenuecat.

2. 2

   Webhook in RevenueCat hinzufügen. Füg im RevenueCat-Dashboard InfluTo als Webhook-Integration hinzu, mit deiner Endpoint-URL und Authorization-Header. RevenueCat unterstützt mehrere Webhook-Integrationen pro Projekt — deine bestehenden Webhooks laufen unangetastet weiter. Behandle den Auth-Header als Geheimnis; InfluTo weist nicht authentifizierte Events ab, und du kannst das Secret rotieren, falls es leakt.

3. 3

   In der Sandbox testen. RevenueCat markiert jedes Event mit seiner Umgebung — Sandbox-Käufe sind also von Produktionskäufen unterscheidbar. Lass deine App gegen einen Sandbox-Store-Account laufen, wende einen Test-Empfehlungscode an, schließ ein Sandbox-Abo ab und sieh zu, wie die attribuierte Conversion auftaucht. Hast du einen KI-Agent über MCP verbunden, meldet influto_integration_status genau, welche Teile die Plattform gesehen hat — SDK-Aktivität, Webhook-Events, attribuierte Test-Conversions — und influto_test_integration fährt den Check live. Überspring das nicht: Ein am Launch-Tag stillschweigend kaputtes Programm verbrennt Creator-Vertrauen, das du nicht zurückbekommst.

4. 4

   Live gehen. Lad die vorausbezahlte Wallet auf (erstattungsfähig, über Stripe), erstell die Kampagne, lad Creator ein. Ab hier ist die Pipeline autonom: Events kommen an, Provision entsteht, Stripe Connect bezahlt Creator monatlich aus der Wallet mit einem $20-Minimum. Setup kostenlos, 10 % Plattformgebühr auf den zugeordneten Umsatz.

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

Was du nicht ändern musst

Nichts an deinem bestehenden RevenueCat-Setup bewegt sich. Entitlements, Offerings, Paywalls, deine aktuellen Webhooks und Analytics — alles unangetastet. RevenueCat bleibt deine Umsatz-Quelle der Wahrheit; die Affiliate-Schicht ist ein Subscriber-Attribut plus ein zusätzlicher Webhook-Konsument. Entfernst du sie irgendwann, löschst du die Webhook-Integration und die Attribut-Schreibvorgänge — und dein Abo-Stack ist exakt, wie er war. Die kürzere Produktzusammenfassung dieser Integration steht auf der Feature-Seite zur RevenueCat-Integration, unten verlinkt — und einrichten kannst du sie heute kostenlos.