> ## Documentation Index > Fetch the complete documentation index at: https://supastack.dev/llms.txt > Use this file to discover all available pages before exploring further. > For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt # Настройка покупок 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 — около часа, в основном в ожидании настройки магазинных продуктов. [Создайте мобильные аккаунты](https://supastack.dev/ru/docs/mobile/external-accounts.md) [Соберите клиент разработки](https://supastack.dev/ru/docs/mobile/eas-setup.md) ## Создание аккаунта и проекта RevenueCat 1. Откройте [app.revenuecat.com](https://app.revenuecat.com) → зарегистрируйтесь и создайте проект с названием вашего продукта. Ожидается: пустой дашборд проекта с вкладками Apps, Products, Entitlements, Offerings и API keys — следующие разделы заполняют их по порядку. ## Создайте магазинные продукты, затем привяжите оба приложения Магазинные продукты должны существовать до того, как RevenueCat сможет на них ссылаться. iOS: [appstoreconnect.apple.com](https://appstoreconnect.apple.com) → My Apps → создайте запись приложения с вашим `ios.bundleIdentifier` → In-App Purchases или Subscriptions → создайте подписочные продукты, которые планируете продавать (они могут оставаться черновиками, пока вы тестируете). Android: [play.google.com/console](https://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= 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. [Соберите и проверьте на устройствах](https://supastack.dev/ru/docs/mobile/builds.md) [Веб-оформление вместо этого использует Stripe](https://supastack.dev/ru/docs/web/stripe-payments.md) Чтобы продолжить настройку, прочитайте [Сборки и проверка на устройствах](https://supastack.dev/ru/docs/mobile/builds.md). ## Вперёд [Сборки и проверка на устройствах](https://supastack.dev/ru/docs/mobile/builds.md)