Партнерська інтеграція RevenueCat: повний гайд.

Чому вебхук — джерело правди

Партнерська програма платить реальні гроші, тож тригером комісії має бути щось, чого не може підробити ні клієнтський пристрій, ні автор. Вебхук RevenueCat має саме потрібні властивості:

• Він сервер-до-сервера. Події народжуються в бекенді RevenueCat після того, як він валідував базову транзакцію магазину. Ніщо у вашому бінарнику застосунку не може таку підробити.

• Він уже покриває обидва магазини. Один вебхук несе події підписок iOS та Android в одному форматі, тож партнерському шару байдуже, з якого магазину чек.

• Він несе subscriber attributes. Це стрижень усієї інтеграції: довільні пари ключ-значення, задані користувачу, подорожують із кожною подією про нього.

На InfluTo це один із двох підтримуваних шляхів верифікації — другий: пряма валідація App Store Server API / Google Play для застосунків без RevenueCat. На застосунок обираєте рівно один, ніколи обидва: два джерела правди про ті самі гроші — саме так народжуються баги подвійного обліку.

Як атрибуція їде вебхуком

Крок за кроком через життя одного приведеного користувача:

1. 1

   Код доходить до SDK. Автор ділиться своїм кодом. Користувач встановлює ваш застосунок, і код доходить до SDK — введений вручну чи принесений реферальним посиланням.

2. 2

   SDK позначає користувача в RevenueCat. SDK InfluTo записує його як subscriber attribute influto_code у RevenueCat. Відтепер особа автора подорожує з користувачем усередині самого RevenueCat. Кліки на лінк автора вже дедупліковані й фрод-позначені на боці InfluTo; збіг коду ж детермінований — без fingerprinting, без IDFA, без запиту ATT.

3. 3

   Вебхук спрацьовує; конверсія створюється. Коли користувач підписується, RevenueCat валідує транзакцію магазину й надсилає вебхук. InfluTo зчитує з події influto_code, зіставляє автора й створює конверсію.

Три події, що мають значення

• INITIAL_PURCHASE. Перша підписочна транзакція користувача. Вона створює конверсію й фіксує ставку комісії: ставка на старті підписки лишається ставкою на весь час життя цього підписника, тож зміни ставки посеред кампанії ніколи тихо не переоцінюють наявних підписників автора. Одна критична деталь: перевіряйте period type події. Старт пробного періоду теж приходить як INITIAL_PURCHASE, а пробний період — не дохід: комісія з нього не нараховується.

• RENEWAL. Двигун повторюваності. Кожна подія продовження додає одне нарахування комісії зіставленому автору. Тут же користувач із пробного стає комісійним: коли пробний конвертується в платний, з'являється платна транзакція — і комісія стартує. Правило, що тримає все чесним, просте: комісія йде за верифікованими грошима, тож автори заробляють на конверсіях пробних періодів — ніколи на їх стартах. Це також означає, що автори не можуть фармити комісію одноразовими пробними реєстраціями — що захищає ваш ескроу і ваші дані.

• CANCELLATION. Механізм чесності. Вимкнене автопродовження означає, що події продовжень перестають приходити — і нарахування зупиняється разом із ними. Повернення означає, що гроші, з яких вам нарахували комісію, розвернулися — саме тому InfluTo утримує комісію до кінця вікна повернень, перш ніж вона стане виплатною. Завдяки утриманню повернена підписка просто ніколи не виплачується; вам не треба бігати за автором по гроші, що вже пішли. (Події закінчення закривають цикл, коли доступ справді завершується.)

Налаштування за чотири кроки

1. 1

   Встановіть SDK і задайте атрибут. Swift, Kotlin, Flutter чи React Native/Expo — відкритий код на github.com/influto, близько 5 хвилин. Запис influto_code бере на себе SDK; ви лише передаєте йому код, з яким прийшов користувач. Точні сніпети для кожної платформи: docs.influ.to/integrations/revenuecat.

2. 2

   Додайте вебхук у RevenueCat. У панелі RevenueCat додайте InfluTo як вебхук-інтеграцію з вашим endpoint-URL і заголовком authorization. RevenueCat підтримує кілька вебхук-інтеграцій на проєкт, тож ваші наявні вебхуки працюють далі без змін. Auth-заголовок тримайте в секреті; InfluTo відхиляє неавтентифіковані події, а секрет при витоку можна ротувати.

3. 3

   Протестуйте в sandbox. RevenueCat позначає кожну подію її середовищем, тож sandbox-покупки відрізняються від продакшн. Запустіть застосунок із sandbox-акаунтом магазину, застосуйте тестовий реферальний код, завершіть sandbox-підписку й дивіться, як з'являється атрибутована конверсія. Якщо ви підключили ШІ-агента через MCP, influto_integration_status точно звітує, що платформа вже бачила — активність SDK, події вебхука, атрибутовані тестові конверсії — а influto_test_integration запускає перевірку наживо. Не пропускайте: програма, що тихо зламалася в день запуску, спалює довіру авторів, яку не повернути.

4. 4

   Виходьте в продакшн. Поповніть ескроу-гаманець (повертається, через Stripe), створіть кампанію, запросіть авторів. Далі конвеєр автономний: події приходять, комісія накопичується, Stripe Connect платить авторам з гаманця з мінімумом $1. Налаштування безкоштовне, 10% комісія платформи з комісій.

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

Що вам не доведеться міняти

У вашому наявному налаштуванні RevenueCat ніщо не рухається. Entitlement-и, offering-и, paywall-и, ваші поточні вебхуки й аналітика — все без змін. RevenueCat лишається вашим джерелом правди про дохід; партнерський шар — це один subscriber attribute плюс один додатковий споживач вебхука. Якщо колись його приберете — видаляєте вебхук-інтеграцію й записи атрибута, і ваш підписочний стек точно такий, як був. Коротший, продуктовий підсумок — на сторінці функції інтеграції RevenueCat, лінк нижче — і налаштувати можна безкоштовно вже сьогодні.