5.0.0

RuStore позволяет интегрировать платежи в мобильное приложение.

提示

Если не знаете с чего начать, прочтите инструкцию в сценариях использования.

Пример реализации

Ознакомьтесь с приложением-примером чтобы узнать, как правильно интегрировать SDK платежей.

Условия работы платежей

• На устройстве пользователя установлена актуальная версия RuStore.
• Пользователь авторизован в RuStore.
• Пользователь и приложение не должны быть заблокированы в RuStore.
• Для приложения включена возможность покупок в RuStore Консоли.
• Версия Defold 1.6.2 или выше.

警告

Сервис имеет некоторые ограничения на работу за пределами России.

Подключение в проект

Подключение в проект

1. Скопируйте проекты плагина и приложения-примера из официального репозитория RuStore на GitFlic.
2. Откройте в вашей IDE проект Android из папки extension_libraries.
3. Выполните сборку проекта командой gradle assemble. При успешном выполнении сборки в папках billing_example/extension_rustore_billing/lib/android и billing_example/extension_rustore_core/lib/android будут созданы файлы:
   • RuStoreDefoldBilling.jar;
   • RuStoreDefoldCore.jar.
4. Скопируйте папки billing_example/extension_rustore_billing и billing_example/extension_rustore_core в корень вашего проекта.

Обработка deeplink

Deeplink в RuStore SDK платежей нужна для корректной работы со сторонними приложениями оплаты. Она помогает пользователям быстрее совершать покупки в стороннем приложении и возвращаться в ваше приложение.

Для настройки работы с deeplink в вашем приложении и RuStore SDK, укажите deeplinkScheme внутри вашего AndroidManifest файла и переопределите метод OnNewIntent вашего активити.

AndroidManifest.xml

<activity>
<!-- RUSTORE BILLING INTENT FILTER -->
<activity android:name="ru.rustore.defold.billing.RuStoreIntentFilterActivity" android:exported="true" android:launchMode="singleTask">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <!-- Set your appscheme -->
        <data android:scheme="yourappscheme" />
    </intent-filter>
</activity>

Вместо yourappscheme из примера выше укажите название своей схемы. Например, ru.package.name.rustore.scheme.

信息

Схема, указанная в Androidmanifest файле должна совпадать со схемой, которую вы указываете в методе create RuStore SDK платежей.

Пример приложения содержит модифицированный манифест в файле billing_example / extension_rustore_billing / manifests / android / AndroidManifest.xml

Инициализация

Перед вызовом методов библиотеки необходимо выполнить её инициализацию.

Для инициализации вызовите метод init().

Вызов метода init

local APPLICATION_ID = "123456"
local DEEPLINK_SCHEME = "yourappscheme"
local DEBUG_LOGS = true

rustorebilling.init(APPLICATION_ID, DEEPLINK_SCHEME, DEBUG_LOGS)

• 123456 — код приложения из консоли разработчика RuStore (пример: https://console.rustore.ru/apps/123456).

  Чтобы получить ID приложения, скопируйте цифры из URL-адреса страницы приложения в RuStore Консоли после apps/.

  

• yourappscheme — схема deeplink, необходимая для возврата в ваше приложение после оплаты через стороннее приложение (например, SberPay или СБП). SDK генерирует свой хост к данной схеме.
• debugLogs — флаг, регулирующий ведение журнала событий. Укажите значение true, если хотите, чтобы события попадали в журнал. В ином случае укажите false.

备注

Схема deeplink, передаваемая в yourappscheme, должна совпадать со схемой, указанной в AndroidManifest.xml (подробнее см. Обработка deeplink).

Как работают платежи

Проверка доступности работы с платежами

• На устройстве пользователя установлена актуальная версия RuStore.
• Приложение RuStore поддерживает функциональность платежей.
• Пользователь авторизован в RuStore.
• Пользователь и приложение не должны быть заблокированы в RuStore.
• Для приложения включена возможность покупок в RuStore Консоли.

Перед использованием метода необходимо единожды выполнить подписку на события:

• rustore_check_purchases_available_success;
• rustore_check_purchases_available_failure.

Подписка на события

function init(self)
    # Инициализация rustorebilling
 
    rustorecore.connect("rustore_check_purchases_available_success", _check_purchases_available_success)
    rustorecore.connect("rustore_check_purchases_available_failure", _check_purchases_available_failure)
end
  
function _check_purchases_availability_success(self, channel, value)
    local data = json.decode(value)
end
  
function _check_purchases_availability_failure(self, channel, value)
    local data = json.decode(value)
end

Вызов метода check_purchases_availability

rustorebilling.check_purchases_availability()

Обратный вызов (callback) rustore_check_purchases_availability_success возвращает строку JSON с информацией о доступности сервиса (см. ниже).

• isAvailable — выполнение условий выполнения платежей (true/false).
• cause — информация об ошибке.

Структура ошибки описана в разделе Обработка ошибок.

Обратный вызов (callback) rustore_check_purchases_availability_failure возвращает строку JSON с информацией об ошибке. Структура ошибки описана в разделе Обработка ошибок.

Работа с SDK

Получение списка продуктов

Вы проверили, что платежи доступны и пользователи могут совершать покупки. Теперь можно получить список продуктов. Используйте метод get_products(), чтобы получить информацию о продуктах, добавленных в ваше приложение через RuStore Консоль.

Перед использованием метода необходимо единожды выполнить подписку на события:

• rustore_on_get_products_success;
• rustore_on_get_products_failure.

Подписка на события

function init(self)
    # Инициализация rustorebilling
 
    rustorecore.connect("rustore_on_get_products_success", _on_get_products_success)
    rustorecore.connect("rustore_on_get_products_failure", _on_get_products_failure)
end
 
function _on_get_products_success(self, channel, value)
    local data = json.decode(value)
end
 
func _on_get_products_failure(self, channel, value)
    local data = json.decode(value)
end

Вызов метода get_products

local PRODUCT_IDS = {
    "non_con2",
    "non_con1",
    "con2",
    "con1",
    "sub2",
    "sub1"}
 
rustorebilling.get_products(PRODUCT_IDS)

PRODUCT_IDS — список идентификаторов продуктов. В нём не должно быть более 100 позиций.

Чтобы указать id продуктов, которые нужны для работы метода:

1. Откройте RuStore Консоль.
2. Перейдите на вкладку «Приложения».
3. Выберите нужное приложение.
4. В левом боковом меню выберите раздел «Монетизация».
5. Выберите тип товара: «Подписки» или «Разовые покупки».
6. Скопируйте идентификаторы нужных товаров. Это и есть id продуктов.

Обратный вызов (callback) rustore_on_get_products_success возвращает строку JSON с информацией о продуктах (см. ниже).

• currency — код валюты ISO 4217.
• description — описание на языке language.
• imageUrl — ссылка на картинку.
• language — язык, указанный с помощью BCP 47 кодирования.
• price — цена в минимальных единицах (в копейках).
• priceLable — отформатированная цена товара, включая валютный знак на языке language.
• productId — идентификатор продукта, который был присвоен продукту в RuStore Консоли (обязательный параметр).
• productStatus — тип продукта.
• productType — статус продукта.
• promoImageUrl — ссылка на промокартинку.
• title — название продукта на языке language.
• subscription — описание подписки, возвращается только для продуктов с типом subscription.

Доступные поля объекта subscription (см. ниже).

• subscriptionPeriod — период подписки.
• freeTrialPeriod — пробный период подписки.
• gracePeriod — льготный период подписки.
• introductoryPrice — отформатированная вступительная цена подписки, включая знак валюты, на языке product:language.
• introductoryPriceAmount — вступительная цена в минимальных единицах валюты (в копейках).
• introductoryPricePeriod — расчётный период вступительной цены.

Доступные поля объекта «период» (см. ниже).

• years — количество лет.
• months — количество месяцев.
• days — количество дней.

Обратный вызов (callback) rustore_on_get_products_failure возвращает строку JSON с информацией об ошибке. Структура ошибки описана в разделе Обработка ошибок.

Покупка продукта

Для вызова покупки продукта используйте метод purchase_product().

Перед использованием метода необходимо единожды выполнить подписку на события:

• rustore_on_purchase_product_success;
• rustore_on_purchase_product_failure.

Подписка на события

function init(self)
    # Инициализация rustorebilling
 
    rustorecore.connect("rustore_on_purchase_product_success", _on_purchase_product_success)
    rustorecore.connect("rustore_on_purchase_product_failure", _on_purchase_product_failure)
end
 
function _on_purchase_product_success(self, channel, value)
	local data = json.decode(value)
end
  
function _on_purchase_product_failure(self, channel, value)
    local data = json.decode(value)
end

Вызов метода purchase_product

local PRODUCT_ID = "example_id"
local PARAMS = "{" ..
	"\"orderId\":\"example\"," ..
	"\"quantity\":1," ..
	"\"payload\":\"example\"" ..
	"}"

rustorebilling.purchase_product(PRODUCT_ID, PARAMS)

• PRODUCT_ID — идентификатор продукта, который был присвоен продукту в RuStore Консоли (обязательный параметр);
• PARAMS — опциональные параметры:
  • orderId — уникальный идентификатор оплаты, сформированный приложением (опциональный параметр). Если вы укажете этот параметр в вашей системе, вы получите его в ответе при работе с API. Если не укажете, он будет сгенерирован автоматически;
  • quantity — количество продукта (опциональный параметр);
  • payload — строка с дополнительной информацией о заказе, которую вы можете установить при инициализации процесса покупки.

Обратный вызов rustore_on_purchase_product_success возвращает строку JSON с информацией о покупке. Доступны следующие поля.

• type — тип результата запроса

  :
  • Success - результат успешного завершения покупки цифрового товара;
  • Failure - при отправке запроса на оплату или получения статуса оплаты возникла проблема, невозможно установить статус покупки;
  • Cancelled — запрос на покупку отправлен, при этом пользователь закрыл «платёжную шторку» на своём устройстве, и результат оплаты неизвестен;
  • InvalidPaymentState — ошибка работы SDK платежей. Может возникнуть, в случае некорректного обратного deeplink.

• data — строка JSON с опциональными полями

  .

Объект типа Success возвращается в случае удачного выполнения запроса. Доступны следующие поля.

• orderId — уникальный идентификатор оплаты, сформированный приложением (опциональный параметр). Если вы укажете этот параметр в вашей системе, вы получите его в ответе при работе с API. Если не укажете, он будет сгенерирован автоматически.
• purchaseId — идентификатор покупки.
• productId — идентификатор продукта, который был присвоен продукту в RuStore Консоли (обязательный параметр).
• invoiceId — идентификатор счёта.
• subscriptionToken — токен для валидации покупки на сервере.

Объект типа Failure возвращается в случае ошибки при выполнения запроса. Доступны следующие поля.

• purchaseId — идентификатор покупки.
• invoiceId — идентификатор счёта.
• orderId — уникальный идентификатор оплаты, сформированный приложением (опциональный параметр). Если вы укажете этот параметр в вашей системе, вы получите его в ответе при работе с API. Если не укажете, он будет сгенерирован автоматически.
• quantity — количество продукта (опциональный параметр).
• productId — идентификатор продукта, который был присвоен продукту в RuStore Консоли (обязательный параметр).
• errorCode — код ошибки.

Коды ошибок описаны в разделе Коды ошибок.

Объект типа Cancelled возвращается в случае отмены покупки пользователем. Доступны следующие поля.

• purchaseId — идентификатор покупки.

Объект типа InvalidPaymentState возвращается в случае ошибки работы SDK платежей. Например в случае некорректного обратного deeplink.

Обратный вызов (callback) rustore_on_purchase_product_failure возвращает строку JSON с информацией об ошибке. Структура ошибки описана в разделе Обработка ошибок.

Получение списка покупок

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

Тип/Статус	INVOICE_CREATED	CONFIRMED	PAID
CONSUMABLE	+		+
NON-CONSUMABLE	+	+
SUBSCRIPTION	+	+

备注

Метод возвращает незавершённые состояния покупки и покупки потребляемых товаров, требующих обработки. Помимо этого, он показывает подтверждённые покупки для подписок и непотребляемых товаров — тех, которые нельзя купить повторно.

Для получения списка покупок пользователя используйте метод get_purchases().

Перед использованием метода необходимо единожды выполнить подписку на события:

• rustore_on_get_purchases_success;
• rustore_on_get_purchases_failure.

Подписка на события

function init(self)
    # Инициализация rustorebilling
 
    rustorecore.connect("rustore_on_get_purchases_success", _on_get_purchases_success)
    rustorecore.connect("rustore_on_get_purchases_failure", _on_get_purchases_failure)
end
 
function _on_get_purchases_success(self, channel, value)
    local data = json.decode(value)
 
    for key, value in pairs(data) do
        -- value.amount
    end
end
  
function _on_get_purchases_failure(self, channel, value)
    local data = json.decode(value)
end

Вызов метода get_purchases

rustorebilling.get_purchases()

Обратный вызов (callback) rustore_on_get_purchases_success возвращает массив объектов с информацией о покупках. Доступны следующие поля:

• amount — цена в минимальных единицах валюты.
• amountLable — отформатированная цена покупки, включая валютный знак на языке language.
• currency — код валюты ISO 4217.
• description — описание на языке language.
• developerPayload — строка с дополнительной информацией о заказе, которую вы можете установить при инициализации процесса покупки.
• invoiceId — идентификатор счёта.
• language — язык, указанный с помощью BCP 47 кодирования.
• orderId — уникальный идентификатор оплаты, сформированный приложением (опциональный параметр). Если вы укажете этот параметр в вашей системе, вы получите его в ответе при работе с API. Если не укажете, он будет сгенерирован автоматически.
• productId — идентификатор продукта, который был присвоен продукту в RuStore Консоли (обязательный параметр).
• productType — тип продукта.
• purchaseId — идентификатор покупки.
• purchaseState — состояние покупки:
• purchaseTime — время покупки.
• quantity — количество продукта (опциональный параметр).
• subscriptionToken — токен для валидации покупки на сервере.

Обратный вызов (callback) rustore_on_get_purchases_failure возвращает строку JSON с информацией об ошибке. Структура ошибки описана в разделе Обработка ошибок.

Получение сведений о покупке

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

Перед использованием метода необходимо единожды выполнить подписку на события:

• rustore_on_get_purchase_info_success;
• rustore_on_get_purchase_info_failure.

Подписка на события

function init(self)
    # Инициализация rustorebilling
 
    rustorecore.connect("rustore_on_get_purchase_info_success", _on_get_purchase_info_success)
    rustorecore.connect("rustore_on_get_purchase_info_failure", _on_get_purchase_info_failure)
end
 
function _on_get_purchase_info_success(self, channel, value)
	local data = json.decode(value)
end
  
function _on_get_purchase_info_failure(self, channel, value)
    local data = json.decode(value)
end

Вызов метода get_purchase_info

# Ваша реализация UI запроса информации о покупке
function _on_get_purchase_info_pressed(purchaseId):
    rustorebilling.get_purchase_info(purchaseId)
end

purchaseId — идентификатор покупки

Обратный вызов (callback) rustore_on_get_purchase_info_success возвращает строку JSON с информацией о покупке. Доступны следующие поля:

• amount — цена в минимальных единицах валюты.
• amountLable — отформатированная цена покупки, включая валютный знак на языке language.
• currency — код валюты ISO 4217.
• description — описание на языке language.
• developerPayload — строка с дополнительной информацией о заказе, которую вы можете установить при инициализации процесса покупки.
• invoiceId — идентификатор счёта.
• language — язык, указанный с помощью BCP 47 кодирования.
• orderId — уникальный идентификатор оплаты, сформированный приложением (опциональный параметр). Если вы укажете этот параметр в вашей системе, вы получите его в ответе при работе с API. Если не укажете, он будет сгенерирован автоматически.
• productId — идентификатор продукта, который был присвоен продукту в RuStore Консоли (обязательный параметр).
• productType — тип продукта.
• purchaseId — идентификатор покупки.
• purchaseState — состояние покупки:
• purchaseTime — время покупки.
• quantity — количество продукта (опциональный параметр).
• subscriptionToken — токен для валидации покупки на сервере.

Обратный вызов (callback) rustore_on_get_purchase_info_failure возвращает строку JSON с информацией об ошибке. Структура ошибки описана в разделе Обработка ошибок.

Статусная модель (purchaseState)

Статусная модель покупки потребляемых продуктов (CONSUMABLES)

Статусная модель покупки непотребляемых продуктов (NON-CONSUMABLES)

Статусная модель покупки подписок (SUBSCRIPTIONS)

Потребление (подтверждение) покупки

Продукты, требующие потребления (подтверждения)

Учитывайте тип покупки. Метод потребления (подтверждения) необходим, только если у вас потребляемый товар (CONSUMABLE), который можно купить много раз.

Чтобы такие товары начислились пользователям без ошибок, подтвердите потребление (подтверждение) продукта с помощью метода confirmPurchase. При начислении товара в вашем приложении используйте серверную валидацию платежей. Начисляйте товар только когда платёж (счёт) перейдет в финальный статус CONFIRMED. Начисление продуктов пользователям надо делать в callback addOnSuccessListener метода confirmPurchase.

警告

Статус PAID является промежуточным и означает, что средства пользователя захолдированы на карте и вам нужно потдвердить покупку.

Вызов метода потребления (подтверждения)

Для потребления (подтверждения) покупки используйте метод confirm_purchase(). Запрос на потребление (подтверждение) покупки должен сопровождаться выдачей товара. После вызова подтверждения покупка перейдёт в статус CONSUMED.

Перед использованием метода необходимо единожды выполнить подписку на события:

• rustore_on_confirm_purchase_success;
• rustore_on_confirm_purchase_failure.

Подписка на события

function init(self)
    # Инициализация rustorebilling
     
    rustorecore.connect("rustore_on_confirm_purchase_success", _on_confirm_purchase_success)
    rustorecore.connect("rustore_on_confirm_purchase_failure", _on_confirm_purchase_failure)
end
 
function _on_confirm_purchase_success(self, channel, value)
    local data = json.decode(value)
end
  
function _on_confirm_purchase_failure(self, channel, value)
    local data = json.decode(value)
end

Вызов метода confirm_purchase

# Ваша реализация UI потребления (подтверждения) покупки
function _on_confirm_purchase_pressed(purchaseId):
    rustorebilling.confirm_purchase(purchaseId)
end

• purchaseId — идентификатор покупки.

Валидация покупки на сервере

Если вам необходимо произвести валидацию успешной покупки на сервере методами API RuStore, вы можете использовать значение поля subscriptionToken, возвращаемого в строке json при успешной покупке продукта.

SubscriptionToken состоит из invoiceId покупки и userId, записанных через точку: $invoiceId.$userId.

Получение subscriptionToken из результата покупки

function _on_purchase_product_success(self, channel, value)
    local data = json.decode(value)
 
    if data.type == "Success" then
        local subscriptionToken = data.data.subscriptionToken
        yourApi.validate(subscriptionToken)
    end
end

Также можно получить subscriptionToken из объектов списка покупок.

function _on_get_purchases_success(self, channel, value)
    local data = json.decode(value)

	for key, value in pairs(data) do
        yourApi.validate(value.subscriptionToken)
    end
end

Отмена покупки

Для отмены покупки используйте метод delete_purchase.

Перед использованием метода необходимо единожды выполнить подписку на события:

• rustore_on_delete_purchase_success;
• rustore_on_delete_purchase_failure.

Вызов метода отмены

Подписка на события

function init(self)
    # Инициализация rustorebilling
     
    rustorecore.connect("rustore_on_delete_purchase_success", _on_delete_purchase_success)
    rustorecore.connect("rustore_on_delete_purchase_failure", _on_delete_purchase_failure)
end
 
function _on_delete_purchase_success(self, channel, value)
    local data = json.decode(value)
end
  
function _on_delete_purchase_failure(self, channel, value)
    local data = json.decode(value)
end

Вызов метода delete_purchase

# Ваша реализация UI отмены покупки
function _on_delete_purchase_pressed(purchaseId):
    rustorebilling.delete_purchase(purchaseId)
end

• purchaseId — идентификатор покупки.

Обратный вызов rustore_on_delete_purchase_success возвращает идентификатор покупки:

• purchaseId — идентификатор покупки.

Обратный вызов rustore_on_delete_purchase_failure возвращает строку JSON с информацией об ошибке. Доступны следующие поля:

• purchaseId — идентификатор покупки.
• cause — информация об ошибке.

Структура ошибки описана в разделе Обработка ошибок.

信息

Используйте этот метод, если у вас есть логика, завязанная на удалении покупки. Покупка отменяется автоматически через таймаут в 20 минут, либо при повторной покупке от того же клиента.

Обработка незавершённых платежей

Обработка незавершённых платежей производится разработчиком.

Чтобы подтвердить покупку типа CONSUMABLE и в статусе PAID вызовите метод потребления (подтверждения) покупки (см. Получение сведений о покупке).

В случае с отменой покупки при использовании методов обработки платежей учитывайте свой внутренний процесс. У некоторых разработчиков он предусматривает проверки перед потреблением (подтверждением) или отменой покупки. В этом случае запросите отдельно статус такой покупки.

提示

Например, если пользователь оплатил товар, который вы по каким-то причинам не можете ему поставить, вызовите метод отмены покупки в статусе PAID, чтобы отменить покупку.

В случаях, когда метод получения списка покупок возвращает покупку со статусом INVOICE_CREATED вы можете использовать метод отмены покупки. Например, если не хотите видеть покупку с такими статусами в списке покупок. Делать это самим не обязательно, поскольку RuStore обрабатывает отмену таких покупок на своей стороне.

信息

Иногда после оплаты через приложение банка (СБП, SberPay, Tinkoff Pay и др.) и при последующем возврате обратно в приложение статус покупки остаётся INVOICE_CREATED, при этом статус платежа — неуспешная покупка. Это связано с временем обработки покупки на стороне банка. Поэтому разработчику необходимо правильно связать логику получения списка покупок с жизненным циклом экрана.

Альтернативное решение — отмена покупки в статусе INVOICE_CREATED только через взаимодействие пользователя с приложением. Например, вы можете вынести эту логику в отдельную кнопку.

Ведение журнала событий

Если необходимо логировать события библиотеки платежей, добавьте необязательный параметр debugLogs в вызов init и единожды выполните подписку на события:

• rustore_on_payment_logger_debug;
• rustore_on_payment_logger_error;
• rustore_on_payment_logger_info;
• rustore_on_payment_logger_verbose;
• rustore_on_payment_logger_warning.

local APPLICATION_ID = "123456"
local DEEPLINK_SCHEME = "yourappscheme"
local DEBUG_LOGS = true
local LOG_TAG = "yourtag"

function init(self)
	rustorecore.connect("rustore_on_payment_logger_debug", _on_payment_logger_debug)
	rustorecore.connect("rustore_on_payment_logger_error", _on_payment_logger_error)
	rustorecore.connect("rustore_on_payment_logger_info", _on_payment_logger_info)
	rustorecore.connect("rustore_on_payment_logger_verbose", _on_payment_logger_verbose)
	rustorecore.connect("rustore_on_payment_logger_warning", _on_payment_logger_warning)
	
	rustorebilling.init(APPLICATION_ID, DEEPLINK_SCHEME, DEBUG_LOGS)
end

function _on_payment_logger_debug(self, channel, value)
	rustorecore.log_debug(LOG_TAG, value)
end

function _on_payment_logger_error(self, channel, value)
	rustorecore.log_error(LOG_TAG, value)
end

function _on_payment_logger_info(self, channel, value)
	rustorecore.log_info(LOG_TAG, value)
end		

function _on_payment_logger_verbose(self, channel, value)
	rustorecore.log_verbose(LOG_TAG, value)
end

function _on_payment_logger_warning(self, channel, value)
	rustorecore.log_warning(LOG_TAG, value)
end

Параметр для включения логирования:

• DEBUG_LOGS — включить логи (логи будут автоматически отключены для Release-сборок).

Все обратные вызовы (callbacks) логгирования возвращают строку JSON. Доступные поля:

• e — информация об ошибке или "null". Структура ошибки описана в разделе Обработка ошибок.
• message – описание ошибки.

Смена темы интерфейса

Для динамической смены темы необходимо использовать метод set_theme.

Пример использования setTheme

rustorebilling.set_theme(0)

• 0 - тёмная тема;
• 1 - светлая тема.

Обработка ошибок

Структура ошибки

Обработка json ошибки

function _on_failure(self, channel, value)
    local data = json.decode(value)
	
	local message = data.detailMessage
end

• detailMessage – описание ошибки.

Возможные ошибки

• RuStoreNotInstalledException — на устройстве пользователя не установлен RuStore;
• RuStoreOutdatedException — версия RuStore, установленная на устройстве пользователя, не поддерживает данный SDK;
• RuStoreUserUnauthorizedException — пользователь не авторизован в RuStore;
• RuStoreRequestLimitReached — с момента последнего отображения процесса прошло слишком мало времени;
• RuStoreReviewExists — этот пользователь уже оценил ваше приложение;
• RuStoreInvalidReviewInfo — проблемы с ReviewInfo;
• RuStoreException — базовая ошибка RuStore, от которой наследуются остальные ошибки.

При вызове метода purchase_product ошибки обрабатываются автоматически.

Для показа диалога с ошибкой пользователю используйте метод set_error_handling.

function init(self)
    rustorebilling.set_error_handling(true)
	
	# Инициализация rustorebilling
end

• true — показывать диалог;
• false — не показывать диалог.

Коды ошибок

Ниже представлено описание возможных ошибок в поле errorCode.

HTTP-код	Код ошибки	Описание
400	40001	Параметры запроса неверны — не заполнены обязательные параметры/неверный формат параметров.
400	40003	Приложение не найдено.
400	40004	Статус приложения inactive.
400	40005	Продукт не найден.
400	40006	Статус продукта inactive.
400	40007	Недопустимый тип продукта. Поддерживаемые типы: consumable, non-consumable, subscription.
400	40008	Покупка с таким order_id уже существует.
400	40009	У текущего клиента найдена покупка этого продукта со статусом invoice_created. Необходимо предложить клиенту оплатить/отменить покупку.
400	40010	Для типа продукта consumable. У текущего клиента найдена покупка этого продукта со статусом paid. Сначала требуется подтвердить потребление покупки на устройстве, а затем можно отправлять следующий запрос на покупку этого продукта.
400	40011	Для типа продукта non-consumable. У текущего клиента найдена покупка этого продукта со статусом pre_confirmed/confirmed. Такой продукт уже приобретён. Более одного раза продукт не продаётся.
400	40012	Для типа продукта subscription. У текущего клиента найдена покупка этого продукта со статусом pre_confirmed/confirmed. Такой продукт уже приобретён. Более одного раза продукт не продаётся.
400	40013	Для типа продукта subscription. При обращении в сервис подписок за списком продуктов GET/products (serviceId, user_id) данные не были получены.
400	40014	Обязательный атрибут(-ы) не пришел в запросе.
400	40015	Не удалось изменить статус при обновлении покупки (переход запрещён).
400	40016	При покупке подписки непотребляемого продукта указано значение quantity > 1.
400	40017	Продукт удалён, новые покупки не доступны.
400	40018	Нельзя потреблять продукт с типом тип продукта.
401	40101	Невалидный токен.
401	40102	Время жизни токена истекло.
403	40301	Доступ к запрашиваемому ресурсу запрещён (неавторизованно).
403	40302	Для текущего токена текущий вызов не авторизован (метод запрещён).
403	40303	Идентификатор приложения в запросе и токен не совпадают.
403	40305	Неверный тип токена.
404	40401	Не найдено.
408	40801	Истекло время ожидания уведомления, указанное в запросе.
500	50***	Внутренняя ошибка платежного сервиса.