Обзор: три способа подключиться
Вы выберете, каким из трёх способов приложение узнает об оплате, сделанной на веб-странице.
Человек платит в браузере, и приложению нужно узнать пришедшего и выяснить, открыт ли ему доступ.
Перед началом
- Платный тариф. Связка с приложением работает на Pro и Business. На бесплатном тарифе поля раздела заблокированы и ключ доступа не выпускается.
- Роль владельца или администратора проекта. Остальным ролям ключи доступа и секрет подписи не показываются вовсе. Позвали участником — попросите владельца проекта сменить роль: «Проект и команда», «Передача разработчику».
Какой путь ваш
Тот же вопрос кабинет Subster задаёт при первом входе в раздел «Подключение приложения»: кто в вашем приложении решает, что у человека есть подписка.
| Если у вас | Путь в кабинете | Что вы делаете | Что понадобится |
|---|---|---|---|
| iOS или Android и наша библиотека — со своим сервером или без | «Наша библиотека в приложении» | встраиваете библиотеку; сервер, если он есть, проверяет доступ с ключом | ID проекта; серверу — ключ доступа sk_live_… |
| свой сервер, библиотеку не ставите | «Собственный сервер» | пишете запросы к нам и обработчик событий | ключ доступа sk_live_… |
| подписки ведёт Adapty или RevenueCat | «Подписки живут в стороннем сервисе» | вносите в кабинет ключ платформы и один раз привязываете профиль | секретный ключ и название уровня доступа из кабинета платформы (в RevenueCat оно называется правом) |
Четвёртая карточка, «Приложение не подключаю», — для тех, кто не связывает приложение с воронкой: ключи доступа и события на ваш сервер остаются, оплата в приложение не передаётся.
Не решили, ставить ли библиотеку, — ставьте: кабинет называет её самым простым путём, и свой сервер ей не мешает. Библиотека вместе со своим сервером — это первая строка: на пути «Собственный сервер» кабинет прячет настройку ссылок возврата и не даёт включить режим проверки, в котором приложение видит «оплачено» ещё до настоящей оплаты.
Наша библиотека в приложении
Библиотека (SDK) для iOS и Android: актуальные версии — iOS 0.8.1 и Android 0.7.2. Она достаёт идентификатор покупателя из ссылки возврата, узнаёт человека после установки и отвечает приложению, открыт ли доступ.
Подключение и первый ответ о доступе — «Быстрый старт», все методы библиотеки — «SDK».
Собственный сервер
Библиотеки в приложении нет, весь цикл собирается запросами:
- Приложение меняет код из ссылки возврата на идентификатор покупателя; ссылка потерялась — просит для покупателя письмо с новым кодом. «Как мы узнаём покупателя»
- Ваш сервер спрашивает право доступа с ключом в заголовке
Authorization. «Аутентификация», «Проверить право доступа» - Об оплатах, продлениях, отменах и возвратах сервер узнаёт нашими событиями. «Вебхуки»
- Необязательно: о регистрации или покупке, прошедшей мимо нас, сервер сообщает нам. «Отправить событие нам»
Готовый код на Node для шагов 2 и 3 — «Рецепты».
Подписки в Adapty или RevenueCat
Доступ мы проставляем прямо в вашей подписочной платформе: оплата на веб-странице — доступ у профиля активен, возврат денег — снят. Приложение спрашивает о доступе свою платформу, нашей библиотеки в нём нет.
От вас — ключ платформы в кабинете и один раз пара «наш идентификатор покупателя ↔ профиль в платформе»: параметром в адресе открываемой страницы или запросом с вашего сервера. Подробно — «Adapty и RevenueCat».
Работаете с ИИ-помощником?
Скопируйте промпт и подставьте платформу, есть ли у вас сервер и где живут подписки. Помощник выберет путь и поведёт по нему; как подключить к нему наш MCP-сервер — «MCP-сервер».
I am integrating Subster into a mobile app. Subster takes subscription payments
on a web page and opens the paid access inside the app.
Our setup: <iOS / Android>, <we have our own backend / we have none>,
subscriptions live <in Adapty / in RevenueCat / nowhere yet>.
1. Read the overview of the three ways to connect and tell me which one fits us,
with the reason.
2. Then walk me through that way step by step: what to set up in the cabinet,
what code to write.
3. Take every endpoint, field name and error code from the Subster documentation:
its MCP server is https://api.subster.ai/mcp, or use the pages I attach.
If something is not there, ask me — do not invent names or addresses.Частые вопросы
А можно вообще без своего сервера?
Да: и библиотека, и подписочная платформа работают без него. Цена — доверие: ответ, полученный на устройстве, подделывается вместе с устройством, поэтому пускать в платное надёжнее по ответу вашего сервера.
У Adapty и RevenueCat ещё одна оговорка: без сервера профиль привязывается, только когда страницу оплаты открывает само приложение. Кто платит на сайте до установки, того привязывает ваш сервер — «Adapty и RevenueCat».
А если мы выберем и передумаем?
Путь меняется кнопкой «Сменить» в том же разделе кабинета. Сохранённые настройки продолжают работать, меняется набор показанных полей. Исключение одно: переход на «Собственный сервер» или «Приложение не подключаю» выключает режим проверки.
Дальше
- Быстрый старт — библиотека или свой сервер и первый ответ о доступе покупателя.
- Возврат в приложение — три случая перехода из браузера: приложение открыто, не установлено, установлено.
- Диагностика — что смотреть по жалобе «оплатил, а доступа нет».