Пользователь оплатил доступ, закрыл приложение до ответа — и при следующем входе снова видит предложение купить. Подключение RuStore Pay SDK должно решать весь путь покупки: от выбора продукта до подтверждённого права в аккаунте. Добавление платёжного окна закрывает только клиентскую часть этого процесса.
Связываем каталог магазина с моделью продукта
Определяем, что продаётся, как покупка привязывается к аккаунту и на каких устройствах действует результат. Сопоставляем идентификаторы продуктов RuStore с внутренними предложениями. Цена и текст в интерфейсе должны соответствовать доступному предложению; платёжная операция и предоставленное пользователю право учитываются раздельно.
| Продукт | Что необходимо учитывать | Какой результат хранит система |
| Расходуемая покупка | Однократное зачисление согласованного ресурса | Факт покупки и факт выдачи без повторного начисления |
| Постоянное право | Восстановление ранее приобретённой возможности | Действующее право согласованного аккаунта |
| Подписка | Состояние и срок действия, продление и прекращение | Основание доступа на текущий период |
Доступные типы покупок, способы оплаты и условия подключения сверяем с версией Pay SDK и настройками приложения. Модель из старого BillingClient SDK не переносим без проверки: идентификаторы, состояния и подтверждение операций могут отличаться. Подключение платежей и подготовка самого приложения к RuStore остаются разными работами.
Проектируем клиентский сценарий без ложного успеха
Подключаем выбранную совместимую версию SDK, настраиваем необходимые параметры приложения и переходы. Интерфейс различает загрузку предложения, запуск оплаты, ожидание результата, отказ и подтверждённое приобретение. Возврат пользователя из платёжного приложения не выдаёт доступ сам по себе.
Если операция прервалась, приложение повторно выясняет её состояние. Пользователь должен видеть, что покупка проверяется, и иметь понятный способ восстановить результат. Повторное нажатие не должно создавать дополнительное внутреннее начисление. Отдельно определяем поведение при смене аккаунта: покупка не должна незаметно присваиваться следующему вошедшему человеку.
Проверяем оплату на сервере и выдаём права один раз
На backend сопоставляем идентификатор операции магазина, продукт и пользователя, проверяем результат предусмотренным API и сохраняем основание выдачи. По актуальной документации Pay SDK invoiceId используется для серверной проверки оплаты, а идентификатор покупки — в том числе для сведений о подписке; конкретные методы фиксируем для внедряемой версии.
Проектируем защиту от повторной обработки: повтор запроса, уведомления или сверки должен находить существующий результат. Статус «оплачено» и выполнение внутреннего действия могут наступить в разные моменты. Если выдача прервалась, система должна завершить её по сохранённому основанию, а не требовать у пользователя ещё одну оплату.
Для выбранного платёжного потока реализуем нужное подтверждение или отмену. Секреты серверного API храним в серверной среде. Журнал содержит идентификаторы и причины расхождений, необходимые для поддержки, без платёжных секретов и лишних персональных данных.
Подписки, восстановление и переход со старой интеграции
Для подписки связываем действующее состояние магазина и срок с моделью доступа продукта. Отменённое продление и уже оплаченный период не считаем одним событием; поведение определяем по подтверждённым данным и правилам сервиса. При переустановке или новом устройстве восстанавливаем положенные права согласованного аккаунта.
Если используется старый BillingClient SDK, отдельно сопоставляем каталог, сохранённые идентификаторы, обработчики и серверные контракты. Проверяем старые покупки вместе с новыми, а не только успешную тестовую оплату после замены зависимости. История другого магазина не переносится автоматически: общий доступ между каналами требует собственной согласованной модели.
Контрольные сценарии и результат внедрения
- Отмена, отказ и потеря ответа после оплаты; повторная проверка без второй выдачи.
- Переустановка, вход на другом устройстве и смена пользователя.
- Окончание периода подписки, возврат и другие применимые состояния выбранной схемы.
- Сбой backend между проверкой покупки и выдачей права, последующая сверка результата.
Используем доступные для выбранной версии тестовые инструменты и согласованные проверки выпуска. Для оценки нужны исходники клиента и backend, описание каталога, действующие SDK и правила аккаунтов. Передаём изменения кода, настройки интеграции, модель прав и результаты проверки. Комиссии, условия выплат и доступность монетизации подтверждаются для конкретного разработчика и не заменяются обещаниями исполнителя.
Можно подключить только клиентский SDK без backend?
Для продукта с серверными аккаунтами и управляемыми правами одной клиентской отметки недостаточно. Состав серверной проверки определяем по архитектуре и документации платёжной схемы; сервер может уже существовать, его не обязательно создавать заново.
Переход на Pay SDK означает повторную покупку для всех пользователей?
Не назначаем её автоматически. Нужно исследовать сохранённые покупки, методы их проверки и связи с аккаунтами. Если данные или права другого канала несовместимы, ограничения разбираются до выпуска, а не скрываются за новой платёжной формой.
Связать покупки с правами пользователей
Опишите продукты, подписки и текущую схему выдачи доступа. Проверим клиент, серверные контракты и сохранённые покупки, затем определим состав интеграции Pay SDK.
Обсудить платежи