Виртуальная валюта
Как это работает
Виртуальная валюта — это виртуальные деньги, которые используются для приобретения и продажи виртуальных товаров. В зависимости от использования, виртуальная валюта влияет на экономический баланс игры или связана с монетизацией приложения.
Основные возможности:
- Продажа любого количества виртуальной валюты или пакета виртуальной валюты с фиксированным количеством валюты.
- Продажа премиум-валюты.
- Продажа виртуальной валюты и пакетов виртуальной валюты как за реальную, так и за виртуальную валюту.
- Доставка валюты в инвентарь игрока.
Варианты продажи валюты
Продажа валюты возможна в двух видах:
Продажа любого количества валюты
Предполагает продажу виртуальной валюты в необходимом пользователю количестве. Для этого на клиентской части приложения необходимо реализовать запрос ввода количества валюты при покупке.
Пакеты виртуальной валюты
Позволяют продавать виртуальную валюту в заранее установленном количестве. Цена пакета валюты задается отдельно и может отличаться от стандартной цены аналогичного количества этой же валюты.
ПРИМЕР: “Золотой пакет” содержит 100 золотых монет и стоит 90$ при стоимости золота 1$ за монету.
Ограничения:
- В пакет можно добавить только один тип виртуальной валюты.
- Для пакета виртуальной валюты цена должна быть задана хотя бы в одной валюте — реальной или виртуальной.
- Количество виртуальной валюты в пакете можно задать только целым числом.
Доставка валюты
Виртуальная валюта доставляется:
- В инвентарь (способ по умолчанию). Пакет виртуальной валюты перед доставкой распаковывается, и в инвентарь игрока начисляется виртуальная валюта из его состава.
- В PlayFab, если настроена интеграция.
Премиум-валюта
Премиум-валюта — это виртуальная валюта, которая привязана к платформе, где осуществляется покупка, и которая продается только за реальную валюту.
Ограничения:
- Валюта может быть определена как премиум-валюта только при ее создании, после этого положение переключателя Премиум-валюта изменить нельзя.
- Пакеты с премиум-валютой могут продаваться только за реальную валюту.
Чтобы настроить хранение премиум-валюты раздельно по платформам:
- Установите переключатель Премиум-валюта в положение Вкл.

- При вызове API методов управления инвентарем передайте в поле
platform строку с платформой, для которой совершается покупка.
ПРИМЕР
- html
"platform": “playstation_network”
Для кого подходит
- Для партнеров, которые хотят настроить игровую экономику или монетизацию путем добавления в игру внутриигровой валюты и продажи за нее внутриигровых предметов.
- Для партнеров, у которых подключен хотя бы один из следующих продуктов:
- Внутриигровой магазин с настроенным модулем Виртуальные товары.
Buy Button с настроенным модулем Игровые ключи.
Как настроить
Предварительные действия
- Зарегистрируйтесь в Личном кабинете Иксолла.
- Перейдите к вашему проекту.
- Перейдите в Настройки проекта > Настройки интеграции и убедитесь, что переключатель Интегрировать методы
Commerce API установлен в положение Вкл.
- Настройте модули для продукта Внутриигровой магазин или
Buy Button .
Настройка виртуальной валюты
Вы можете настроить виртуальные валюты одним из следующих способов:
Настройка через Личный кабинет
Чтобы настроить виртуальную валюту через Личный кабинет:
- В Личном кабинете подключите модуль Виртуальная валюта.
- В разделе Магазин > Виртуальная валюта нажмите кнопку Новая виртуальная валюта.
- Задайте необходимые параметры:
- Загрузите изображение виртуальной валюты.
- Укажите артикул виртуальной валюты.
- Укажите название виртуальной валюты.
- Укажите цены в нужных валютах.
- Укажите валюту по умолчанию.
- Если валюта определена как Премиум-валюта, обратитесь к инструкции по ее настройке.
- Проверьте настройки и нажмите Создать валюту.
Чтобы настроить пакет виртуальной валюты через Личный кабинет:
- В Личном кабинете подключите модуль Виртуальная валюта.
- Убедитесь, что в проекте создана хотя бы одна виртуальная валюта.
- Перейдите в раздел Магазин > Виртуальная валюта > Пакеты и нажмите кнопку Новый пакет.

- Задайте необходимые параметры:
- Загрузите изображение пакета.
- Укажите артикул пакета.
- Укажите название пакета.
- Укажите краткое описание пакета.
- Укажите виртуальную валюту в составе пакета.
- Укажите цены пакета в реальной и/или виртуальной валюте.
- Укажите валюту по умолчанию.
- Для отображения пакета в каталоге магазина установите переключатель Показывать в магазине в положение Вкл.
- Проверьте настройки и нажмите Создать пакет.

Настройка через методы API
Для настройки виртуальных валют используются методы подраздела