Мобильные приложенияJava / Kotlin

RuStore Pay SDK на Kotlin: добавляем тестовую покупку без устаревшего BillingClient

Подключаем актуальный RuStore Pay SDK к Android-приложению на Kotlin, запускаем тестовую покупку и правильно обрабатываем успех, отмену и ошибку.

Кодик

Автор

6 мин чтения

RuStore Pay SDK можно освоить на одном небольшом проекте, если сразу видеть вход, действие и результат. Pay SDK заменил устаревший BillingClient и даёт единый сценарий покупки с явной обработкой результата и серверной проверкой. Ниже вы соберёте работающий пример и проверите обычный и граничный сценарии.

Старые статьи продолжают показывать BillingClient, хотя после 1 августа 2026 года платежи через него больше не обрабатываются. Поэтому отделим настройку, входные данные, основное действие и проверку. В этой статье вы соберёте тестовую покупку продукта coins_100 с отдельными состояниями loading, success, cancelled и error. Проверка: платёжная шторка открывается в sandbox, отмена не выдаёт товар, а успешный purchaseId передаётся на серверную проверку.

1Соберите минимум

создать продукт coins_100 в RuStore Консоли. Не расширяйте проект до первого успешного запуска.

2Увидьте данные

платёжная шторка открывается. Проверяйте значение, а не отсутствие ошибки.

3Измените правило

После успеха добавьте идемпотентную выдачу товара по 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, покупка и проверка. Следующий шаг начинается после совпадения с ожидаемым результатом.

Путь данных в проекте RuStore Pay SDK
От входных данных до видимого результата. Сначала проверяется вход, затем действие и только потом интерфейс.

Зафиксируйте первый успех Убедитесь, что applicationId, подпись APK и карточка приложения совпадают с данными RuStore Консоли. Иначе 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.
  • Повторный запуск даёт тот же предсказуемый результат.
  • Пустой ввод получает понятное сообщение вместо падения.

Главная функция принимает явный вход и возвращает результат, который можно проверить отдельно от интерфейса. Найдите в примере вход, проверку и место формирования результата.

Хрупкий и проверяемый вариант RuStore Pay SDK
Что отличает устойчивый проект от случайного запуска. Явные границы делают ошибку локальной и понятной.

Что происходит внутри и почему это работает

Клиентский результат сообщает, чем закончилась шторка, но не должен быть единственным доказательством покупки. Backend проверяет purchaseId и делает выдачу идемпотентной. Логику держите отдельно от вывода: функция получает аргумент и возвращает значение, а интерфейс показывает его. Для подписок требуется авторизация VK ID. Разовые покупки и подписки имеют разные статусы, поэтому не сводите их к одному флагу isPaid.

ЧастьЗа что отвечаетЧто проверить
Productописывает товар в консолиproductId совпадает с приложением
Pay SDKоткрывает оплату и возвращает purchaseIdотмена выделена отдельно
Backendпроверяет статус и выдаёт ценностьповторный webhook не дублирует выдачу

Если сеть оборвалась после оплаты, приложение может не увидеть красивый success. Поэтому источник истины находится на сервере: он повторно запрашивает статус и хранит обработанные purchaseId. Не прячьте поток в одном обработчике: сохраните вход, проверьте его, вызовите операцию и только затем обновите интерфейс.

Проверьте границу Отмените шторку, повторите покупку и имитируйте повторный ответ backend. Баланс должен увеличиться ровно один раз. Меняйте одно условие за прогон, чтобы видеть причину.

Проверяем проект и добавляем свою функцию

Добавьте экран истории покупок и функцию восстановления, которая спрашивает backend, а не доверяет локальному SharedPreferences. До правки запишите ожидаемое поведение одним предложением. После граничного теста повторите обычный сценарий.

Проверка своими руками
  1. Сохраните ожидаемый результат: платёжная шторка открывается в sandbox, отмена не выдаёт товар, а успешный purchaseId передаётся на серверную проверку.
  2. Измените правило: добавьте идемпотентную выдачу товара по purchaseId. Сначала предскажите итог.
  3. Передайте граничное значение и убедитесь, что приложение не падает.
  4. Верните корректные данные и объясните роли трёх основных частей.
Готово, если выполняются все пункты
  • productId доступен тестовой сборке
  • платёжная шторка открывается
  • получен ProductPurchaseResult или ошибка
  • товар выдаётся после подтверждения

После изменения повторите основной и ошибочный сценарии, чтобы новое поведение не сломало исходный результат. Полезная правка проходит от нового ввода до видимого результата.

Четыре контрольные точки RuStore Pay SDK
Четыре проверки перед следующим шагом. Каждый следующий этап начинается после наблюдаемого результата.

Что запомнить и куда двигаться дальше

Перед production отключите sandbox, проверьте подпись release-сборки, серверные уведомления и возвраты. Не переносите примеры BillingClient в новый проект. Для закрепления откройте в публикации Android-приложения, в статье про платёжный webhook и в первом приложении Kotlin.

Как изучить тему в Кодике

Сначала разберите формат входных данных и одну функцию, затем подключайте внешний сервис или интерфейс. Сначала восстановите главную функцию и проверьте её на трёх значениях.

ШагЧто разобратьМини-проверка
1. ОсноваКлассы, sealed-состояния и callback KotlinОбъясните вход и выход функции.
2. ИнструментProductPurchaseParams, Pay SDK и deeplinkПовторите команду по памяти.
3. ПроектSandbox-покупку и обработку отменыПроверьте два сценария.
4. РефакторингСерверную валидацию, идемпотентность и возвратыРазделите ввод, логику и вывод.

Закрепите проект, восстановив ключевую функцию по памяти и добавив собственный граничный случай. Базовый синтаксис закрепите через курс Kotlin.

Старый BillingClient

После 1 августа 2026 года платежи не обрабатываются. Используйте Pay SDK.

Выдача по локальному success

Модифицированный APK может подделать состояние. Проверяйте покупку на сервере.

Одинаковый orderId

Повторное использование путает попытки. Генерируйте уникальное значение.

Нет обработки отмены

Пользователь видит техническую ошибку вместо нормального возврата в магазин.

Сверяйтесь с первичной документацией. Команды и ограничения примера проверены по официальному источнику 1. Если версия инструмента изменилась, официальный источник важнее старого скриншота.

Что получится в итоге

Готовый результат проекта: RuStore Pay SDK на Kotlin: добавляем тестовую покупку без устаревшего BillingClient
Финальный экран показывает результат, состояние операции и понятное сообщение об ошибке без раскрытия секретов.

Короткие ответы
Почему нельзя выдать товар только по onSuccess?

Клиент находится под контролем пользователя. Сервер должен проверить purchaseId и статус.

Что делать с повторным уведомлением о покупке?

Обработать его идемпотентно и не выдавать товар второй раз.

Что проверять первым, если RuStore Pay SDK не запускается?

Версию среды, текущую папку, команду запуска и первую строку ошибки.

Как понять, что проект RuStore Pay SDK работает?

Проверьте основной сценарий, неверный ввод, повторный запуск и один граничный случай.

Можно ли начать с готового кода?

Да. Добейтесь результата, измените одно правило и восстановите ключевую функцию без копирования.

Сделайте один осознанный шаг дальше

Выберите одно улучшение и проведите его от ввода до результата.

Если не хватает основы, перейдите курс Kotlin, затем восстановите ключевую функцию без подсказки.