For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ru/docs/mobile/revenuecat.md (or send Accept: text/markdown).
Настройка покупок RevenueCat
Создайте проект RevenueCat, привяжите ваши продукты App Store и Play и подключите SDK-ключи плюс серверные секреты, проверяющие покупки.
Прохождение для начинающих
Зачем это существует: Apple и Google требуют, чтобы цифровые покупки внутри приложения шли через их собственный биллинг — никогда через Stripe Checkout — и комплект обеспечивает эту границу. RevenueCat лежит поверх обоих магазинов, так что одна интеграция покрывает iOS и Android: она отслеживает чеки, подписки и восстановления, а ваш сервер спрашивает у RevenueCat, платил ли воркспейс.
Предварительные условия: аккаунты Apple Developer Program ($99 в год) и Google Play Console ($25 один раз) из руководства по мобильным аккаунтам — магазинные продукты должны существовать до того, как RevenueCat сможет их связать — плюс EAS-сборка разработки для реального теста, потому что Expo Go вообще не может запускать нативный модуль покупок. Бесплатный тариф RevenueCat покрывает тестирование; ничто из этого не списывает денег до выхода продуктов.
Кратко о терминах: проект RevenueCat хранит ваши приложения, связанные с магазинами. Продукты — магазинные товары, отражённые внутри RevenueCat. Entitlement — флаг, который RevenueCat выдаёт, пока подписка активна — по умолчанию pro. Offering собирает продукты в пейволл, который показывает приложение. Публичные SDK-ключи идут в мобильный env; секретный API-ключ и авторизация webhook остаются на стороне сервера.
Что вы создаёте: один проект, два приложения со связью с магазинами, продукты, один entitlement, один offering — около часа, в основном в ожидании настройки магазинных продуктов.
Создание аккаунта и проекта RevenueCat
1. Откройте app.revenuecat.com → зарегистрируйтесь и создайте проект с названием вашего продукта.
Ожидается: пустой дашборд проекта с вкладками Apps, Products, Entitlements, Offerings и API keys — следующие разделы заполняют их по порядку.
Создайте магазинные продукты, затем привяжите оба приложения
Магазинные продукты должны существовать до того, как RevenueCat сможет на них ссылаться. iOS: appstoreconnect.apple.com → My Apps → создайте запись приложения с вашим ios.bundleIdentifier → In-App Purchases или Subscriptions → создайте подписочные продукты, которые планируете продавать (они могут оставаться черновиками, пока вы тестируете). Android: play.google.com/console → создайте приложение → Monetize → Products → Subscriptions (или встроенные продукты).
Затем привяжите оба внутри RevenueCat: Apps → New app. Для iOS выберите App Store, введите bundle id и предоставьте креденшелы App Store Connect, которые просит форма — она ссылается на собственные документы настройки RevenueCat для каждого поля. Для Android выберите Play Store, введите имя пакета и загрузите JSON сервисного аккаунта Play — связанные документы проводят его создание в Google Cloud.
Ожидается: оба приложения перечислены под проектом, и консоли магазинов показывают существующие продукты — состояние черновика на этом этапе нормально.
Продукты, entitlement, offering
1. Products → New: создайте по одному продукту RevenueCat на каждый магазинный продукт и привяжите соответствующий id продукта App Store или Play — id должны точно совпадать с консолями.
2. Entitlements → New: назовите его в соответствии с REVENUECAT_ENTITLEMENT_ID — по умолчанию комплекта это pro — и привяжите продукты, которые его выдают.
3. Offerings → New: создайте offering, добавьте пакеты, указывающие на ваши продукты, и отметьте его Current — приложение читает offerings.current, когда рендерит пейволл.
Держите REVENUECAT_ENTITLEMENT_KEY на значении по умолчанию ai.reference-task: это внутренний ключ реестра комплекта — тот же ключ, что выдают поставляемые веб-планы — и доступ RevenueCat записывается под ним. Переименовывайте только когда меняется ключ плана вашего продукта.
Скопируйте ключи и зарегистрируйте webhook
Project → API keys перечисляет три вида ниже. Публичные поплатформенные SDK-ключи (appl_… для iOS, goog_… для Android) идут в apps/mobile/.env.local — они идентифицируют приложение, не несут полномочий трат, и префикс EXPO_PUBLIC_ для них корректен.
Секретный API-ключ (sk_…, ключ v1) и авторизация webhook — только для сервера в apps/web/.env.local — никогда EXPO_PUBLIC_, никогда в коммитах. Сервер вызывает subscriber API RevenueCat с секретным ключом, чтобы проверить состояние покупок каждого воркспейса.
Webhook: RevenueCat → Integrations → Webhooks → установите URL {APP_URL}/api/billing/webhook/revenuecat и значение заголовка Authorization — любую длинную случайную строку, которую вы придумаете — затем положите точно такую же строку в REVENUECAT_WEBHOOK_AUTHORIZATION. Комплект сравнивает заголовок дословно и отклоняет всё остальное, поэтому продления, отмены и возвраты достигают сервера, не дожидаясь следующего запуска приложения.
Песочные покупки принимаются автоматически вне продакшена; REVENUECAT_ALLOW_SANDBOX=true в продакшен-env отклоняется при запуске, поэтому оставляйте его неустановленным после выхода в онлайн.
# apps/mobile/.env.local
EXPO_PUBLIC_MOBILE_PURCHASES_PROVIDER=revenuecat
EXPO_PUBLIC_REVENUECAT_IOS_API_KEY=appl_…
EXPO_PUBLIC_REVENUECAT_ANDROID_API_KEY=goog_…
# apps/web/.env.local — server side
MOBILE_PURCHASES_PROVIDER=revenuecat
REVENUECAT_SECRET_API_KEY=sk_…
REVENUECAT_WEBHOOK_AUTHORIZATION=<the exact Authorization value set on the webhook>
REVENUECAT_ENTITLEMENT_ID=pro
REVENUECAT_ENTITLEMENT_KEY=ai.reference-taskПроверка песочной покупкой
Покупки работают только внутри сборки разработки или продакшена — в Expo Go нативный модуль полностью отсутствует, поэтому этот шаг предполагает, что eas build --profile development произвёл dev-клиент (руководство EAS собирает его).
1. Установите dev-сборку на устройство или симулятор, вошедший в песочный аккаунт: App Store Connect → Users and Access → Sandbox Testers для iOS; Play Console → license testing для Android.
2. В приложении откройте пейволл и купите песочным аккаунтом. Ожидается: покупка завершается в песочнице — без реального списания — восстановление покупок работает, и entitlement воркспейса показывает активный, записанный на стороне сервера под ключом ai.reference-task.
Частые сбои: пустой пейволл означает, что offering не Current или продукты не привязаны; падающая покупка на устройстве означает, что магазинный продукт ещё в черновике или вошёл не тот песочный аккаунт; entitlement, который никогда не переворачивается, означает, что MOBILE_PURCHASES_PROVIDER/EXPO_PUBLIC_MOBILE_PURCHASES_PROVIDER выключены или Authorization webhook не совпадает — дашборд RevenueCat перечисляет статус каждой доставки webhook.
Чтобы продолжить настройку, прочитайте Сборки и проверка на устройствах.