Subster.aiSubster.aiSubster.ai
RU

Начало

Быстрый старт

Вы подключите библиотеку или свой сервер и получите от нас первый ответ о доступе покупателя — от получаса до дня, смотря берёте ли вы нашу библиотеку.

Отдайте задачу ИИ-помощнику

Скопируйте промпт, оставьте в нём свою платформу и подставьте ID проекта.

I am integrating Subster into a mobile app. Subster takes subscription payments
on a web page, outside the app store, and opens the paid access inside the app.

Platform: iOS / Android / server-side code in <language>
API address: https://api.subster.ai
Project ID: <PROJECT_ID>

What the app has to do:
1. get the buyer id (guid) from the link that returns the user to the app
   after payment;
2. ask Subster for that buyer's entitlement;
3. open the paid flow if at least one of the returned grants has
   status "active".

Take every endpoint and field name from the Subster documentation: its MCP
server is https://api.subster.ai/mcp, or use the pages I attach. If a field or
an endpoint is not there, ask me — do not invent names or addresses.

Как подключить MCP-сервер к помощнику — «MCP-сервер».

Перед началом

Значения лежат в кабинете: Настройки проекта → Подключение приложения → Для разработчика. Вкладка появляется, когда в разделе выбран путь подключения.

  • ID проекта — в секции «Начало работы». Вставьте его в сниппет как есть.
  • Адрес API — https://api.subster.ai, он же в поле «Адрес API».
  • Ключ доступа sk_live_… — только для запросов с вашего сервера, библиотеке он не нужен. Выпускается в секции «Ключи доступа» владельцем или администратором проекта на тарифе Pro — «Аутентификация».

Кабинет открылся не на том языке — переключите его в «Личных настройках» → «Персонализация»: «Аккаунт и безопасность».

Сниппет под вашу платформу

Тот же код с вашим ID проекта показан в кабинете, в секции «Начало работы».

iOS

В Xcode: File → Add Package Dependencies, адрес https://github.com/web2web-dev/web2app-ios-sdk.git, версия 0.9.0, продукт Web2AppSDK. Нужна iOS 14 или новее.

import Web2AppSDK

// once at launch — baseUrl is a URL, not a String
Web2App.configure(projectId: "<PROJECT_ID>", baseUrl: URL(string: "https://api.subster.ai")!)

// identify the buyer: pass the one-time code from the return link,
// or nil on first launch without a link — then the library tries the device fingerprint
Web2App.identify(deepLinkValue: code) { result in
    // .success(guid); .failure(.needsEmailFallback) — nothing matched:
    // ask for an email and call Web2App.requestEmailRecovery(email) { _ in }
}

// check access
Web2App.entitlement { grant in
    let isPaid = grant?.isActive ?? false
}

Android

Нужен Android 7.0 или новее. Библиотека берётся из JitPack:

// settings.gradle.kts
dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven { url = uri("https://jitpack.io") }
    }
}

// build.gradle.kts of the app module
dependencies {
    implementation("com.github.web2web-dev:web2app-android-sdk:0.7.2")
}
import app.web2app.sdk.Web2AppSdk

// once at launch — needs a context, baseUrl is a String
Web2AppSdk.configure(context, "<PROJECT_ID>", "https://api.subster.ai")

// first launch after install from Google Play: the library reads Install Referrer itself
Web2AppSdk.identify(
    onResult = { result -> result.onSuccess { guid -> /* buyer identified */ } },
    onNeedEmail = { /* nothing matched: ask for an email, then Web2AppSdk.requestEmailRecovery(email) { } */ },
)

// check access
Web2AppSdk.entitlement { grant -> val isPaid = grant?.isActive == true }

Без кода из ссылки библиотека узнаёт покупателя сама: на iOS — по отпечатку устройства, на Android — по данным, которые Google Play передаёт приложению при установке (Install Referrer). Как это устроено — «Как мы узнаём покупателя».

Если приложение открыли ссылкой возврата, код из неё отдаётся другим методом — «Возврат в приложение», шаг 3.

Библиотека отвечает по самой новой записи о доступе, остальные не смотрит. Если у покупателя бывает больше одной покупки — скажем, подписка и разовая докупка, — решайте по всему списку записей (grants): готовый код в «Рецептах», раздел «Проверить доступ из приложения без библиотеки».

Свой сервер

Библиотека не нужна: приложение меняет код из ссылки возврата на идентификатор покупателя, а ваш сервер спрашивает право с ключом.

# 1. in the app: exchange the one-time code from the return link for a buyer id
curl "https://api.subster.ai/public/handoff/resolve?code=<CODE>"
# { "success": true, "data": { "guid": "abc123def456", "projectId": "…" } }

# 2. on your server: check that buyer's access
curl "https://api.subster.ai/s2s/v1/entitlement?guid=abc123def456" \
  -H "Authorization: Bearer sk_live_…"
# { "guid": "abc123def456", "testMode": false, "grants": [{ "level": "premium", "status": "active", … }] }

Меняйте код с устройства, а не с сервера: обмен принимает десять запросов в минуту с одного IP-адреса, и сервер упрётся в этот потолок, как только покупатели пойдут потоком.

Первый ответ о доступе

  1. Откройте в браузере https://api.subster.ai/public/entitlement?guid=abc123def456 — подойдёт любой идентификатор от 8 до 64 знаков.
  2. Пришло { "guid": "abc123def456", "testMode": false, "grants": [] } — адрес верный, покупок у такого покупателя нет.
  3. Действующую запись до настоящей оплаты покажут режим проверки или тестовая карта — «Диагностика», раздел «Проверить, не дожидаясь настоящей оплаты».

Весь путь целиком

  1. Оплата. Покупатель платит на пейволле, вне магазина приложений. Из рекламы он попадает туда через вашу воронку, от вас ничего не нужно; из приложения — по ссылке, которую ваш сервер получает запросом POST /s2s/v1/users: «Возврат в приложение», раздел «Продажа кнопкой внутри приложения».
  2. Возврат. Экран после оплаты и письмо ведут покупателя в приложение ссылкой возврата с одноразовым кодом, а если приложения нет — сначала в магазин: «Возврат в приложение».
  3. Опознание. Приложение меняет код на идентификатор покупателя, а после установки узнаёт его другими путями: «Как мы узнаём покупателя».
  4. Проверка доступа. Доступ открыт, если среди записей есть хотя бы одна со статусом active: «Проверить право доступа».
  5. Дальше по подписке. О продлениях, отменах и возвратах ваш сервер узнаёт нашими событиями, приложение — повторным запросом права: «Вебхуки».

Дальше

  • Возврат в приложение — три значения от вас, чтобы ссылка после оплаты открывала приложение, а не веб-страницу.
  • SDK — все методы библиотеки: письмо-восстановление, пейволл из приложения, события встроенного окна.
  • Рецепты — проверка доступа, обработчик вебхука и отмена подписки готовым кодом на Node.
  • Диагностика — покупатель заплатил, а доступа в приложении нет.
  • Обзор: три способа подключиться — если вы ещё выбираете между библиотекой, своим сервером и Adapty или RevenueCat.