RuStore Pay SDK можно освоить на одном небольшом проекте, если сразу видеть вход, действие и результат. Pay SDK заменил устаревший BillingClient и даёт единый сценарий покупки с явной обработкой результата и серверной проверкой. Ниже вы соберёте работающий пример и проверите обычный и граничный сценарии.
Старые статьи продолжают показывать BillingClient, хотя после 1 августа 2026 года платежи через него больше не обрабатываются. Поэтому отделим настройку, входные данные, основное действие и проверку. В этой статье вы соберёте тестовую покупку продукта coins_100 с отдельными состояниями loading, success, cancelled и error. Проверка: платёжная шторка открывается в sandbox, отмена не выдаёт товар, а успешный purchaseId передаётся на серверную проверку.
создать продукт coins_100 в RuStore Консоли. Не расширяйте проект до первого успешного запуска.
платёжная шторка открывается. Проверяйте значение, а не отсутствие ошибки.
После успеха добавьте идемпотентную выдачу товара по purchaseId. Так копирование станет практикой.
Как устроен учебный проект RuStore Pay SDK
Android-клиент создаёт ProductPurchaseParams и открывает Pay SDK, backend подтверждает покупку по API, а доступ выдаётся только после серверного решения. Держите ввод, логику и отображение раздельно: тогда каждый этап можно проверить отдельно.
| Этап | Действие | Проверяемый результат |
|---|---|---|
| Товар | создать продукт coins_100 в RuStore Консоли | productId доступен тестовой сборке |
| SDK | подключить Pay SDK и deeplink | платёжная шторка открывается |
| Покупка | вызвать purchase с ONE_STEP | получен ProductPurchaseResult или ошибка |
| Проверка | передать purchaseId на backend | товар выдаётся после подтверждения |
Контрольные точки: товар, sdk, покупка и проверка. Следующий шаг начинается после совпадения с ожидаемым результатом.

От входных данных до видимого результата. Сначала проверяется вход, затем действие и только потом интерфейс.
Собираем рабочий пример шаг за шагом
Материал сверялся с Pay SDK 11.1.0 и инструкцией миграции с BillingClient 2 ноября 2026 года. Подключите актуальный Pay SDK 11.1.0 по официальной инструкции, включите sandbox и создайте тестовый продукт в консоли. Проверьте текущую папку через pwd или Get-Location. Вставьте пример целиком, выполните один раз, затем разбирайте по частям.
fun buyCoins(
onSuccess: (String) -> Unit,
onCancelled: () -> Unit,
onError: (Throwable) -> Unit,
) {
val params = ProductPurchaseParams(
productId = ProductId("coins_100"),
orderId = UUID.randomUUID().toString(),
quantity = 1,
developerPayload = null,
appUserId = null,
)
RuStorePayClient.instance.getPurchaseInteractor()
.purchase(
params = params,
preferredPurchaseType = PreferredPurchaseType.ONE_STEP,
sdkTheme = SdkTheme.LIGHT,
)
.addOnSuccessListener { result -> onSuccess(result.purchaseId.value) }
.addOnFailureListener { error ->
if (error is RustorePaymentException.ProductPurchaseCancelled) {
onCancelled()
} else {
onError(error)
}
}
}- Sandbox открывает платежную шторку для productId coins_100 и возвращает purchaseId.
- Отмена и техническая ошибка попадают в разные ветки, товар не выдаётся локально до проверки backend.
- Повторный запуск даёт тот же предсказуемый результат.
- Пустой ввод получает понятное сообщение вместо падения.
Главная функция принимает явный вход и возвращает результат, который можно проверить отдельно от интерфейса. Найдите в примере вход, проверку и место формирования результата.

Что отличает устойчивый проект от случайного запуска. Явные границы делают ошибку локальной и понятной.
Что происходит внутри и почему это работает
Клиентский результат сообщает, чем закончилась шторка, но не должен быть единственным доказательством покупки. Backend проверяет purchaseId и делает выдачу идемпотентной. Логику держите отдельно от вывода: функция получает аргумент и возвращает значение, а интерфейс показывает его. Для подписок требуется авторизация VK ID. Разовые покупки и подписки имеют разные статусы, поэтому не сводите их к одному флагу isPaid.
| Часть | За что отвечает | Что проверить |
|---|---|---|
| Product | описывает товар в консоли | productId совпадает с приложением |
| Pay SDK | открывает оплату и возвращает purchaseId | отмена выделена отдельно |
| Backend | проверяет статус и выдаёт ценность | повторный webhook не дублирует выдачу |
Если сеть оборвалась после оплаты, приложение может не увидеть красивый success. Поэтому источник истины находится на сервере: он повторно запрашивает статус и хранит обработанные purchaseId. Не прячьте поток в одном обработчике: сохраните вход, проверьте его, вызовите операцию и только затем обновите интерфейс.
Проверяем проект и добавляем свою функцию
Добавьте экран истории покупок и функцию восстановления, которая спрашивает backend, а не доверяет локальному SharedPreferences. До правки запишите ожидаемое поведение одним предложением. После граничного теста повторите обычный сценарий.
- Сохраните ожидаемый результат: платёжная шторка открывается в sandbox, отмена не выдаёт товар, а успешный purchaseId передаётся на серверную проверку.
- Измените правило: добавьте идемпотентную выдачу товара по purchaseId. Сначала предскажите итог.
- Передайте граничное значение и убедитесь, что приложение не падает.
- Верните корректные данные и объясните роли трёх основных частей.
- productId доступен тестовой сборке
- платёжная шторка открывается
- получен ProductPurchaseResult или ошибка
- товар выдаётся после подтверждения
После изменения повторите основной и ошибочный сценарии, чтобы новое поведение не сломало исходный результат. Полезная правка проходит от нового ввода до видимого результата.

Четыре проверки перед следующим шагом. Каждый следующий этап начинается после наблюдаемого результата.
Что запомнить и куда двигаться дальше
Перед production отключите sandbox, проверьте подпись release-сборки, серверные уведомления и возвраты. Не переносите примеры BillingClient в новый проект. Для закрепления откройте в публикации Android-приложения, в статье про платёжный webhook и в первом приложении Kotlin.
Как изучить тему в Кодике
Сначала разберите формат входных данных и одну функцию, затем подключайте внешний сервис или интерфейс. Сначала восстановите главную функцию и проверьте её на трёх значениях.
| Шаг | Что разобрать | Мини-проверка |
|---|---|---|
| 1. Основа | Классы, sealed-состояния и callback Kotlin | Объясните вход и выход функции. |
| 2. Инструмент | ProductPurchaseParams, Pay SDK и deeplink | Повторите команду по памяти. |
| 3. Проект | Sandbox-покупку и обработку отмены | Проверьте два сценария. |
| 4. Рефакторинг | Серверную валидацию, идемпотентность и возвраты | Разделите ввод, логику и вывод. |
Закрепите проект, восстановив ключевую функцию по памяти и добавив собственный граничный случай. Базовый синтаксис закрепите через курс Kotlin.
После 1 августа 2026 года платежи не обрабатываются. Используйте Pay SDK.
Модифицированный APK может подделать состояние. Проверяйте покупку на сервере.
Повторное использование путает попытки. Генерируйте уникальное значение.
Пользователь видит техническую ошибку вместо нормального возврата в магазин.
Что получится в итоге

Финальный экран показывает результат, состояние операции и понятное сообщение об ошибке без раскрытия секретов.
Почему нельзя выдать товар только по onSuccess?
Клиент находится под контролем пользователя. Сервер должен проверить purchaseId и статус.
Что делать с повторным уведомлением о покупке?
Обработать его идемпотентно и не выдавать товар второй раз.
Что проверять первым, если RuStore Pay SDK не запускается?
Версию среды, текущую папку, команду запуска и первую строку ошибки.
Как понять, что проект RuStore Pay SDK работает?
Проверьте основной сценарий, неверный ввод, повторный запуск и один граничный случай.
Можно ли начать с готового кода?
Да. Добейтесь результата, измените одно правило и восстановите ключевую функцию без копирования.
Выберите одно улучшение и проведите его от ввода до результата.
Если не хватает основы, перейдите курс Kotlin, затем восстановите ключевую функцию без подсказки.