
Содержание
Внутриигровые покупки
Необходимо импортировать модуль Payments.
Для платформы Яндекс Игры прочитайте раздел их документации Внутриигровые покупки. Там необходимо отправить запрос о подключении и активировать тестовые покупки.
При использовании внутриигровых покупок на платформе Яндекс Игры необходимо сохранять прогресс в облако. Поэтому требуется использование модуля Storage или PlayerStats.
После добавления товаров в каталог, можно приступать к настройке инапов в Unity.
Симуляция отображения покупок в Unity Editor
Чтобы плагин симулировал получение каталога товаров в Unity Editor, настройте эту симуляцию в свойствах модуля.
Purchases — это массив товаров для симуляции. Создайте или измените элементы массива и их параметры.

Готовое решение
Самый простой способ — использовать готовый префаб Payments Catalog из папки модуля Prefabs. Он автоматически отображает каталог всех товаров. Он создаёт экземпляры префаба из поля Purchase Prefab.
По умолчанию в данном поле ссылка на готовый префаб Purchase. Такой префаб должен иметь скрипт PurchaseYG
Скрипт PurchaseYG — отображает товар, все его данные. Можно использовать готовый префаб Purchase для отображения одного продукта. Для этого необходимо заполнить поле ID. Настройте остальное по предпочтениям.
При использовании префабов PluginYG рекомендуется создавать свой префаб вариант для избежания проблем при обновлении плагина.
Активация покупки
Описанный ниже способ используется при включённом AutoConsume в настройках Payments (включён по умолчанию). Плагин вызывает событие выдачи и затем автоматически подтверждает покупку. Если перед подтверждением необходимо дождаться сохранения, используйте ручную обработку.
Чтобы выдать товар после его приобретения, подпишитесь на событие YG2.onPurchaseSuccess. Оно передаёт ID покупки.
Сохранять купленные товары рекомендуется в PlayerStats.
Есть событие неуспешной покупки YG2.onPurchaseFailed, также передаёт ID покупки.
Обратите внимание на скрипт Receiving Purchase Example, он содержит следующий пример:
Консумирование (обязательно)
Может произойти ошибка, при которой деньги будут заплачены, но в игре товар не будет добавлен. При запуске игры необходимо проверять такие покупки и выдавать недополученное вознаграждение.
Расходуемые товары (например, монеты) после выдачи и сохранения нужно консумировать. Постоянные товары (например, отключение рекламы) консумировать не нужно: они остаются на платформе для восстановления.
Консумировать — это подтвердить использование покупки. После этого она исчезнет из списка непотреблённых покупок платформы. В обычном режиме следующие методы сами вызывают событие выдачи и подтверждают покупку:
YG2.ConsumePurchases — консумировать все покупки
YG2.ConsumePurchaseByID — консумировать одну покупку, необходимо передать ID
Оба метода имеют перегрузку onPurchaseSuccess.
По умолчанию данный параметр равен true — значит для необработанных покупок будет вызвано событие успешной покупки (onPurchaseSuccess).
При значении false — событие успешной покупки не будет вызвано, в таком случае необходимо самостоятельно выдать продукт. Подробнее будет ниже.
Если ваши скрипты в момент консумирования будут подписаны на метод получения вознаграждения, то оно будет получено.
Вы можете просто воспользоваться компонентом ConsumePurchasesYG. Установите его на какой-либо объект, и когда он будет активен, скрипт проверит и консумирует необработанные покупки, если они есть, и вызовет для них событие вознаграждения. По умолчанию на префабе Payments Catalog уже содержится скрипт ConsumePurchasesYG.
Ручная обработка покупок
Для Яндекс Игр добавлен API обработки отдельных транзакций. Отключите AutoConsume в настройках Payments. Этот способ работает с клиентскими покупками, без backend-режима. В Unity Editor доступна симуляция.
Порядок обработки: получить покупку → выдать награду → сохранить → подтвердить расходуемую покупку. Для проверки сохранения используйте callback Storage или PlayerStats.
API транзакций
Событие YG2.onPurchaseReceived передаёт полученную после оплаты транзакцию PaymentTransaction из пространства имён YG.Utils.Pay:
productID — ID товара из каталога. У повторных покупок одного товара он одинаковый.
purchaseToken — уникальный токен конкретной покупки. Используйте его для подтверждения и защиты от повторной выдачи.
YG2.GetPendingPurchases() — запросить непотреблённые покупки. Результат приходит в событие YG2.onGetPendingPurchases как массив PaymentTransaction[]. Запрос сам не выдаёт награды и не подтверждает покупки. Вызывайте его при запуске после готовности SDK, чтобы восстановить покупки.
YG2.ConsumePurchaseByToken(purchaseToken) — подтвердить одну расходуемую покупку. Вызывайте только после успешного сохранения награды.
События результата:
YG2.onGetPendingPurchasesFailed— ошибка получения списка, передаёт текст ошибки.YG2.onPurchaseConsumed— покупка подтверждена, передаёт токен.YG2.onPurchaseConsumeFailed— подтвердить покупку не удалось, передаёт токен. Это не означает, что оплата не прошла.
Сохраняйте токен обработанной расходуемой покупки вместе с наградой. Если подтверждение не прошло, платформа может вернуть ту же транзакцию повторно — награду за неё нельзя выдавать второй раз.
В ручном режиме используйте onPurchaseReceived для выдачи новых покупок. Не вызывайте одновременно старые методы ConsumePurchases и ConsumePurchaseByID: они могут подтвердить транзакции до завершения вашего сохранения.
Пример ManualPaymentsExample
В папке модуля Example/Scripts есть скрипт ManualPaymentsExample. Для него нужны модули Storage и PlayerStats.
- По умолчанию скрипт выключен условием
PAYMENTS_MANUAL_EXAMPLEв начале файла, добавьте этот символ в Scripting Define Symbols или в коде закомментируйте только часть&& PAYMENTS_MANUAL_EXAMPLE. - В настройках модуля отключите AutoConsume. Для билда включите облачное сохранение в Storage, если выключено.
- Добавьте компонент ManualPaymentsExample на объект сцены.
- В компоненте укажите ID товаров в полях Coins Product ID и Permanent Product ID. По умолчанию —
coins100иremove_ads. Для билда создайте эти товары в каталоге Яндекс Игр (в черновике).
Скрипт сам ждёт готовности SDK и запрашивает непотреблённые покупки. Пока компонент включён, в правом нижнем углу отображается панель с данными и кнопками покупки и восстановления.
Многоразовая покупка coins100 начисляет монеты. Баланс paymentsExampleCoins и список выданных токенов paymentsExampleTokens сохраняются вместе в Storage. После успешного сохранения транзакция подтверждается.
Постоянная покупка remove_ads сохраняет значение 1 в PlayerStats по ключу paymentsExamplePermanent и не консумируется.
Очередь в примере обрабатывает покупки по одной. При ошибке сохранения обработка останавливается; после восстановления связи используйте кнопку восстановления или перезагрузите страницу.
Остальное API
После получения данных о покупках от SDK платформы — выполняется событие onGetPayments. Оно используется для обновления информации о покупках, вызывается при старте игры.
Метод YG2.BuyPayments(string id) — открыть окно, в котором можно совершить покупку.
Если подключить пространство имён YG.Utils.Pay, то появится доступ к классу Purchase. Он имеет следующие поля:
id — идентификатор товара.
title — название товара.
description — описание товара.
imageURIimageURI — URL изображение товара.
price — стоимость товара в формате <цена> <код валюты>.
priceValue — стоимость товара в формате <цена>.
priceCurrencyCode — код валюты.
currencyImageURL — адрес иконки валюты.
consumed — использован ли товар. true — использован, false — не использован.
Поле YG2.purchases — массив всех товаров, тип Purchase[].
Метод YG2.PurchaseByID — принимает ID товара, по нему выдаёт информацию о продукте (возвращает экземпляр класса Purchase).
Поле YG2.langPayments — язык в формате «код страны».
В YG2.player (требуется модуль Autorization) имеется интересное поле payingStatus:
Перезагрузите страницу. После перезагрузки необработанные покупки должны быть обработаны и выданы.