Партнёрская интеграция RevenueCat: полное руководство.

Почему вебхук — источник истины

Партнёрская программа платит настоящие деньги, поэтому триггером комиссии должно быть то, что не могут подделать ни клиентское устройство, ни автор. У вебхука RevenueCat ровно нужные свойства:

• Он server-to-server. События рождаются на бэкенде RevenueCat после того, как он проверил транзакцию в сторе. Ничто в бинарнике вашего приложения не может их подделать.

• Он уже покрывает оба стора. Один вебхук несёт события подписок iOS и Android в одном формате, так что партнёрскому слою всё равно, из какого стора пришёл чек.

• Он несёт атрибуты подписчика. Это шарнир всей интеграции: произвольные пары ключ–значение, которые вы ставите пользователю, едут с каждым событием об этом пользователе.

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

Как атрибуция едет на вебхуке

Шаг за шагом по жизни одного приведённого пользователя:

1. 1

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

2. 2

   SDK помечает пользователя в RevenueCat. SDK InfluTo записывает его как атрибут подписчика influto_code в RevenueCat. С этого момента личность автора едет с пользователем внутри самого RevenueCat. Клики по ссылке автора уже были дедуплицированы и помечены на фрод на стороне InfluTo; но совпадение кода детерминировано — без фингерпринтинга, без IDFA, без запроса ATT.

3. 3

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

Три события, которые важны

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

• RENEWAL. Двигатель регулярности. Каждое событие продления добавляет одному сопоставленному автору одно начисление комиссии. Здесь же пользователь на триале становится комиссионным: когда триал конвертируется в оплату, появляется платёжная транзакция — и комиссия начинается. Правило, которое держит всё честным, простое: комиссия следует за подтверждёнными деньгами, поэтому авторы зарабатывают на конверсиях триалов и никогда — на их стартах. Это также значит, что авторы не могут фармить комиссию, нагоняя одноразовые триал-регистрации, — что защищает и ваш escrow, и ваши данные.

• 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 и заголовком авторизации. RevenueCat поддерживает несколько вебхук-интеграций на проект, так что существующие вебхуки продолжают работать нетронутыми. Обращайтесь с заголовком авторизации как с секретом; InfluTo отклоняет неаутентифицированные события, а при утечке секрет можно ротировать.

3. 3

   Протестируйте в sandbox. RevenueCat помечает каждое событие его окружением, так что sandbox-покупки отличимы от продакшн. Запустите приложение под sandbox-аккаунтом стора, примените тестовый реферальный код, оформите sandbox-подписку и смотрите, как появляется привязанная конверсия. Если вы подключили ИИ-агента через MCP, influto_integration_status сообщает ровно, какие части платформа увидела — активность SDK, события вебхука, привязанные тестовые конверсии — а influto_test_integration запускает проверку вживую. Не пропускайте это: программа, тихо сломанная в день запуска, сжигает доверие авторов, которое уже не вернуть.

4. 4

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

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

Что менять не нужно

Ничего в вашей существующей настройке RevenueCat не сдвигается. Entitlements, offerings, пейволы, текущие вебхуки и аналитика — всё нетронуто. RevenueCat остаётся вашим источником истины о выручке; партнёрский слой — это один атрибут подписчика плюс один дополнительный потребитель вебхука. Если когда-нибудь его уберёте — удалите вебхук-интеграцию и записи атрибута, и ваш подписочный стек ровно такой, каким был. Короткое продуктовое резюме этой интеграции — на странице функции интеграции RevenueCat, ссылка ниже, а настроить её можно бесплатно уже сегодня.