RuStore Pay SDK и RuFlow: как устроена интеграция
Платёж начинается с предложения в вашем приложении. На пейволе пользователь видит продукты и выбирает покупку. Затем приложение вызывает RuStore Pay SDK: магазин показывает платёжный интерфейс и возвращает результат операции.
RuFlow добавляет конструктор пейволов, связь продуктов с правами доступа, серверную проверку покупки и аналитику воронки. Секреты магазина остаются на сервере. Приложение получает профиль доступа и решает, какие функции открыть.
RuFlow — независимая платформа, а не официальный SDK RuStore и не эквайринг. Набор способов оплаты и требования к продавцу определяет магазин. Для настройки самого платёжного SDK используйте официальную документацию RuStore Pay SDK.
Как подключить оплату RuStore в приложение
- Подготовьте магазин и продукты. Подключите монетизацию в консоли RuStore, настройте товары или подписки и проверьте идентификаторы, цены и периоды. Сценарий должен соответствовать требованиям RuStore.
- Создайте приложение в RuFlow. Сопоставьте продукты магазина с правом, например premium. Публичный ключ идентифицирует приложение; административный ключ и секреты провайдера не включайте в мобильную сборку.
- Подключите SDK под вашу платформу. Для Kotlin настройте зависимости и Android manifest, передавайте intent в SDK. Во Flutter подключите пакет RuFlow и завершите настройки Android-части. Поддержка оплаты на iOS в пилоте не заявлена.
- Опубликуйте пейвол. Добавьте продукты, преимущества и условия предложения. Свяжите опубликованную версию с размещением, например home, и вызовите показ из приложения.
- Обработайте результат и обновите доступ. Отмена и ошибка оплаты не дают premium. После проверки покупки сервером получите свежий профиль и проверьте нужное право доступа.
Зависимости, порядок настройки и пример кода собраны в быстром старте RuFlow. Для отдельной платформы откройте интеграцию Android / Kotlin или Flutter / Android.
Проверка оплаты перед запуском
Пройдите полную цепочку на вашем merchant-аккаунте и устройстве: показ предложения, платёжный экран, результат, серверная проверка и обновление доступа. Демонстрационный пейвол и успешная загрузка SDK сами по себе не подтверждают рабочую оплату.
- Успешная покупка открывает нужное право у правильного пользователя.
- Отмена, ошибка сети и повторный результат не выдают лишний доступ.
- Возврат и изменение подписки отражаются после проверки состояния магазина.
- Переустановка и смена устройства проходят по выбранному сценарию восстановления доступа.
- Фактический показ и подтверждённая покупка различаются в аналитике.
В текущем пилоте состояние покупок проверяется сервером и периодически сверяется с RuStore. Входящие callback-уведомления магазина отключены; это нужно учитывать при выборе ожидаемого времени обновления доступа. Подробнее — события и доставка.
Посмотрите модель подписок и premium-доступа или опишите свой сценарий для пилота.
Обсудить подключение →