RevenueCat affiliate integráció: a teljes útmutató.

Miért a webhook az igazságforrás

Egy partnerprogram valódi pénzt fizet, ezért a jutalék kiváltójának olyasminek kell lennie, amit sem a kliens-eszköz, sem az alkotó nem tud meghamisítani. A RevenueCat webhookja pontosan a megfelelő tulajdonságokkal bír:

• Szerverek között megy. Az események a RevenueCat backendjéből indulnak, miután az érvényesítette a mögöttes áruházi tranzakciót. Az app binárisodban semmi sem tud ilyet hamisítani.

• Már most lefedi mindkét áruházat. Egyetlen webhook viszi az iOS- és Android-előfizetési eseményeket egy formátumban, így az affiliate rétegnek mindegy, melyik áruházból jött a nyugta.

• Hordozza a subscriber attribute-okat. Ez az egész integráció sarokpontja: a felhasználóra beállított tetszőleges kulcs-érték párok a felhasználó minden eseményével együtt utaznak.

Az InfluTón ez a két támogatott ellenőrzési út egyike — a másik a közvetlen App Store Server API / Google Play nyugtaellenőrzés a RevenueCat nélküli appokhoz. Apponként pontosan egyet választasz, sosem mindkettőt: két igazságforrás ugyanarra a pénzre — pontosan így születnek a duplán számoló hibák.

Hogyan utazik az attribúció a webhookon

Lépésről lépésre, egy ajánlott felhasználó életén át:

1. 1

   A kód eljut az SDK-hoz. Az alkotó megosztja a kódját. A felhasználó telepíti az appodat, és a kód eljut az SDK-hoz — begépelve, vagy az ajánlólink hozza magával.

2. 2

   Az SDK megjelöli a felhasználót a RevenueCatben. Az InfluTo SDK beírja influto_code subscriber attribute-ként a RevenueCatbe. Innentől az alkotó azonossága magában a RevenueCatben utazik együtt a felhasználóval. Az alkotó linkjére érkező kattintásokat az InfluTo oldalán már dedupláltuk és csalásjelöléssel láttuk el; a kódegyezés viszont determinisztikus — se fingerprinting, se IDFA, se ATT-engedélykérés.

3. 3

   A webhook elsül; létrejön a konverzió. Amikor a felhasználó előfizet, a RevenueCat érvényesíti az áruházi tranzakciót, és elküldi a webhookot. Az InfluTo leolvassa az eseményről az influto_code-ot, párosítja hozzá az alkotót, és létrehozza a konverziót.

A három esemény, ami számít

• INITIAL_PURCHASE. A felhasználó első előfizetési tranzakciója. Ez hozza létre a konverziót, és ez rögzíti a jutalékrátát: az előfizetés indulásakor érvényes ráta marad az előfizető teljes élettartamára, így a kampány közbeni rátamódosítások sosem árazzák át csendben egy alkotó meglévő előfizetőit. Egy kritikus részlet: nézd meg az esemény period type-ját. A próbaidőszak indulása is INITIAL_PURCHASE-ként érkezik, a próbaidőszak pedig nem bevétel — utána nem jár jutalék.

• RENEWAL. Az ismétlődés motorja. Minden megújulási esemény egy jutalékelszámolást ír jóvá a párosított alkotónak. Itt válik a próbaidőszakos felhasználó is jutalékképessé: amikor a próba fizetőssé alakul, megjelenik a fizetős tranzakció, és elindul a jutalék. A mindent korrektben tartó szabály egyszerű — a jutalék az igazolt pénzt követi, tehát az alkotó a próbaidőszak konverziója után keres, sosem az indulása után. Ez azt is jelenti, hogy az alkotók nem tudnak eldobható próbaregisztrációkkal jutalékot farmolni, ami a letétedet és az adataidat is védi.

• CANCELLATION. A korrektség mechanizmusa. Kikapcsolt automatikus megújításnál elmaradnak a megújulási események, és velük leáll az elszámolás is. A visszatérítés azt jelenti, hogy a pénz, ami után jutalékot terheltünk, visszafordult — ezért az InfluTo a visszatérítési ablak végéig visszatartja a jutalékot, mielőtt az kifizethetővé válna. A visszatartás miatt egy visszatérített előfizetés egyszerűen sosem kerül kifizetésre; nem kell az alkotó után szaladnod olyan pénzért, ami már elment. (A lejárati események zárják a kört, amikor a hozzáférés ténylegesen véget ér.)

Beállítás négy lépésben

1. 1

   Telepítsd az SDK-t, és állítsd be az attribute-ot. Swift, Kotlin, Flutter vagy React Native/Expo — nyílt forráskód a github.com/influto címen, kb. 5 perc. Az influto_code beírását az SDK intézi; te csak átadod neki a kódot, amivel a felhasználó érkezett. Pontos kódrészletek platformonként: docs.influ.to/integrations/revenuecat.

2. 2

   Add hozzá a webhookot a RevenueCatben. A RevenueCat irányítópultján add hozzá az InfluTót webhook-integrációként a végpont-URL-lel és az authorization fejléccel. A RevenueCat projektenként több webhook-integrációt támogat, így a meglévő webhookjaid érintetlenül működnek tovább. Az auth fejlécet kezeld titokként; az InfluTo elutasítja a hitelesítetlen eseményeket, a titkot pedig szivárgás esetén rotálhatod.

3. 3

   Tesztelj sandboxban. A RevenueCat minden eseményt megjelöl a környezetével, így a sandbox-vásárlások megkülönböztethetők az élesektől. Futtasd az appodat sandbox áruházi fiókkal, adj meg egy teszt-ajánlókódot, vidd végig a sandbox-előfizetést, és figyeld, ahogy megjelenik az attribuált konverzió. Ha MCP-n keresztül AI agentet kötöttél be, az influto_integration_status pontosan jelenti, mit látott már a platform — SDK-aktivitást, webhook-eseményeket, attribuált tesztkonverziókat —, az influto_test_integration pedig élőben futtatja az ellenőrzést. Ne hagyd ki: az induláskor csendben elromlott program olyan alkotói bizalmat éget el, amit nem kapsz vissza.

4. 4

   Élesíts. Töltsd fel a letéti egyenleget (visszatéríthető, Stripe-on át), hozd létre a kampányt, hívd meg az alkotókat. Innentől a folyamat önjáró: érkeznek az események, gyűlik a jutalék, a Stripe Connect pedig $1 minimummal fizeti az alkotókat az egyenlegből. Beállítás ingyen, 10% platformdíj a jutalékokra.

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

Amihez nem kell hozzányúlnod

A meglévő RevenueCat-beállításodból semmi sem mozdul. Entitlementek, offeringek, paywallok, a jelenlegi webhookjaid és analitikád — mind érintetlen marad. A RevenueCat marad a bevételed igazságforrása; az affiliate réteg egy subscriber attribute plusz egy további webhook-fogyasztó. Ha valaha eltávolítod, törlöd a webhook-integrációt és az attribute-írásokat, és az előfizetési rendszered pontosan olyan, mint volt. A rövidebb, termékszintű összefoglaló a lent linkelt RevenueCat-integrációs funkcióoldalon él — és már ma ingyen beállíthatod.