Виртуальная валюта

Как это работает

Виртуальная валюта — это виртуальные деньги, которые используются для приобретения виртуальных товаров. В зависимости от использования, виртуальная валюта влияет на экономический баланс игры или связана с монетизацией приложения.

Основные возможности:

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

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

Доступны следующие способы продажи виртуальной валюты:

Любая сумма — позволяет продавать виртуальную валюту в количестве, которое указывает пользователь. Чтобы использовать эту опцию, реализуйте на стороне клиента поле ввода, в котором пользователь сможет указать желаемое количество валюты при покупке.
Пакеты — позволяют продавать виртуальную валюту в предопределенных количествах. Цена пакета валюты задается отдельно и может отличаться от стандартной цены такого же количества этой валюты.

Пример: Пакет содержит 100 золотых монет и стоит $90, при том что цена одной золотой монеты — $1.

Ограничения:

В пакет можно добавить только один тип виртуальной валюты.
Цену в другой виртуальной валюте можно настроить только с помощью методов API.

Пакет виртуальной валюты можно сделать бесплатным — без указания цены в реальных деньгах или виртуальной валюте. Это можно настроить в Личном кабинете или с помощью методов API. Бесплатную виртуальную валюту, не входящую в пакет, можно создать только с помощью методов API.

Пакет виртуальной валюты можно сделать бесплатным — без указания цены в реальных деньгах или виртуальной валюте. Это можно настроить в вашем аккаунте или с помощью методов API. Бесплатную виртуальную валюту, не входящую в пакет, можно создать только с помощью методов API.

Пакет виртуальной валюты можно сделать бесплатным — без указания цены в реальных деньгах или виртуальной валюте. Это можно настроить в аккаунте для мобильных игр или с помощью методов API. Бесплатную виртуальную валюту, не входящую в пакет, можно создать только с помощью методов API.

Количество виртуальной валюты в пакете можно задать только целым числом.

Как настроить

Настройка в Личном кабинете

Настройка в вашем аккаунте

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

Откройте проект в Личном кабинете и перейдите в раздел Items catalog > All items > Virtual currencies.

Откройте проект в аккаунте и перейдите в раздел Items catalog > All items > Virtual currencies.

Откройте проект в аккаунте и перейдите в раздел Items catalog > All items > Virtual currencies.

Откройте проект в аккаунте и перейдите в раздел Items catalog > All items > Virtual currencies.

Откройте проект в аккаунте для мобильных игр и перейдите в раздел Catalog.

Нажмите Создать товары и в раскрывающемся списке выберите Виртуальная валюта.

В разделе Общие настройки укажите:
- артикул;
- одну или несколько групп, которым должен принадлежать предмет (опционально);
- название;
- краткое описание;
- расширенное описание — чтобы добавить его, включите соответствующий переключатель (опционально).

В разделе Медиа загрузите одно или несколько изображений или видео (опционально) — с устройства или по ссылке. В магазине, созданном с помощью редактора сайтов Xsolla, во всех карточках товара отображается файл с меткой Main, остальные файлы доступны только в карточках с медиагалереей. Файл с меткой Main также возвращается в ответах методов API получения каталога.

В разделе Настройки цен задайте цену или создайте бесплатный товар:
- Чтобы задать цену, выберите тип товара — Платный товар, активируйте переключатель Цены в реальной валюте и укажите цену. При необходимости настройте региональные цены.
- Чтобы создать бесплатный предмет, выберите тип товара – Бесплатный товар.

Чтобы ограничить количество предметов, доступное для покупки:
1. Активируйте переключатель в разделе Лимиты покупок и введите необходимое число.
2. Настройте частоту обновления лимитов, для этого в раскрывающемся списке выберите период:
  - Каждый день.
  - Каждую неделю.
  - Каждый месяц.
  - Настроить интервал. Интервал рассчитывается от даты начала периода показа предмета в магазине.
  - Без регулярного обновления.
3. Задайте расписание обновления, указав параметры, соответствующие периоду.

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

Чтобы настроить лимит по времени отображения предмета (опционально):
1. Активируйте переключатель в разделе Добавить период отображения.
2. Укажите часовой пояс, начало и конец периода.

Чтобы не указывать конец периода отображения предмета, активируйте переключатель Без даты окончания.

Чтобы добавить еще один период отображения товара в каталоге, нажмите +. Если у товара несколько периодов отображения, у каждого должна быть дата окончания. Период отображения завершается в последнюю секунду указанной минуты. Например, если указано время окончания 12:00, период длится до 12:00:59.

Настройте атрибуты одним из способов (опционально):
1. Добавьте атрибуты и их значения в формате JSON.
2. Создайте атрибуты и их значения вручную и привяжите их к товарам.

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

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

Нажмите кнопку Создать.
В открывшемся окне выберите статус товара и нажмите Продолжить.

Созданный предмет отобразится в разделе Все товары.

Откройте проект в Личном кабинете и перейдите в раздел Items catalog > All items > Virtual currency packages.

Откройте проект в аккаунте и перейдите в раздел Items catalog > All items > Virtual currency packages.

Откройте проект в аккаунте и перейдите в раздел Items catalog > All items > Virtual currency packages.

Откройте проект в аккаунте и перейдите в раздел Items catalog > All items > Virtual currency packages.

Откройте проект в аккаунте для мобильных игр и перейдите в раздел Catalog.

Нажмите Создать товары и в раскрывающемся списке выберите Виртуальная валюта.

В разделе Общие настройки укажите:
- артикул;
- одну или несколько групп, которым должен принадлежать предмет (опционально);
- название;
- краткое описание;
- расширенное описание — чтобы добавить его, включите соответствующий переключатель (опционально).

В разделе Медиа загрузите одно или несколько изображений или видео (опционально) — с устройства или по ссылке. В магазине, созданном с помощью редактора сайтов Xsolla, во всех карточках товара отображается файл с меткой Main, остальные файлы доступны только в карточках с медиагалереей. Файл с меткой Main также возвращается в ответах методов API получения каталога.

Укажите виртуальную валюту в составе пакета и ее количество.
В разделе Настройки цен задайте цену или создайте бесплатный товар:
- Чтобы задать цену, выберите тип товара – Платный товар, активируйте переключатель Цены в реальной валюте и/или Цены в виртуальной валюте и укажите цену. При необходимости настройте региональные цены.
- Чтобы создать бесплатный товар, выберите тип товара – Бесплатный товар.

Товар может иметь цены в нескольких реальных и виртуальных валютах. В этом случае необходимо указать валюту по умолчанию для каждого типа: одну — среди реальных, одну — среди виртуальных. Цену в виртуальной валюте можно указать, только если виртуальная валюта уже создана в проекте.

Чтобы ограничить количество предметов, доступное для покупки:
1. Активируйте переключатель в разделе Лимиты покупок и введите необходимое число.
2. Настройте частоту обновления лимитов, для этого в раскрывающемся списке выберите период:
  - Каждый день.
  - Каждую неделю.
  - Каждый месяц.
  - Настроить интервал. Интервал рассчитывается от даты начала периода показа предмета в магазине.
  - Без регулярного обновления.
3. Задайте расписание обновления, указав параметры, соответствующие периоду.

Чтобы настроить лимит по времени отображения предмета (опционально):
1. Активируйте переключатель в разделе Добавить период отображения.
2. Укажите часовой пояс, начало и конец периода.

Чтобы не указывать конец периода отображения предмета, активируйте переключатель Без даты окончания.

Настройте атрибуты одним из способов (опционально):
1. Добавьте атрибуты и их значения в формате JSON.
2. Создайте атрибуты и их значения вручную и привяжите их к предметам.

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

Нажмите кнопку Создать.
В открывшемся окне выберите статус товара и нажмите Продолжить.

Созданный предмет отобразится в разделе Все товары.

Настройка через API

Для настройки виртуальной валюты используйте методы подраздела Admin из группы Виртуальные предметы и валюта.

Методы из подраздела Admin не предназначены для построения каталога на клиентской стороне. Не используйте их на лендингах, в веб-магазинах и во внутриигровой логике.

Задача	Метод API
Создать виртуальную валюту.	Создание виртуальной валюты.
Получить виртуальную валюту.	Получение виртуальной валюты.
Получить список виртуальных валют.	Получение списка виртуальных валют.
Обновить виртуальную валюту.	Обновление виртуальной валюты.
Удалить виртуальную валюту.	Удаление виртуальной валюты.
Ограничить количество виртуальной валюты, доступной для покупки.	В методах API Создание виртуальной валюты или Обновление виртуальной валюты укажите следующие параметры: `limits` — задает максимальное количество виртуальной валюты, доступной для покупки. `limits.recurrent_schedule` — определяет, как часто сбрасывается лимит.
Создать пакет виртуальной валюты.	Создание пакета виртуальной валюты.
Получить пакет виртуальной валюты.	Получение пакета виртуальной валюты.
Получить список пакетов виртуальной валюты.	Получение списка пакетов виртуальной валюты (admin).
Обновить пакет виртуальной валюты.	Обновление пакета виртуальной валюты.
Удалить пакет виртуальной валюты.	Удаление пакета виртуальной валюты.
Ограничить количество пакетов виртуальной валюты, доступных для покупки.	В методах API Создание пакета виртуальной валюты или Обновление пакета виртуальной валюты укажите следующие параметры: `limits` — задает максимальное количество пакетов виртуальной валюты, доступных для покупки. `limits.recurrent_schedule` — определяет, как часто сбрасывается лимит.

Подробнее об ограничениях см. следующие руководства:

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

Отображение виртуальной валюты в каталоге

Отображение виртуальной валюты или пакетов виртуальной валюты зависит от того, как реализован каталог — через редактор сайта или с помощью API.

Отображение через редактор сайта

В каталоге магазина можно отобразить только пакеты виртуальной валюты.

Чтобы пакет виртуальной валюты отобразился на вашем сайте:

Создайте пакет виртуальной валюты.
В проекте в Личном кабинете перейдите в раздел Storefronts > Websites.
Нажмите панель нужного сайта.

Создайте пакет виртуальной валюты.
В проекте в вашем аккаунте перейдите в раздел Storefronts > Websites.
Нажмите панель нужного сайта.

Создайте пакет виртуальной валюты.
В проекте в вашем аккаунте перейдите в раздел Storefronts > Websites.
Нажмите панель нужного сайта.

Создайте пакет виртуальной валюты.
В проекте в вашем аккаунте перейдите в раздел Storefronts > Websites.
Нажмите панель нужного сайта.

Создайте пакет виртуальной валюты.
В проекте в аккаунте для мобильных игр перейдите в раздел Web Shop.
Нажмите панель нужного сайта.

Если на сайте несколько страниц, выберите нужную:
1. Нажмите на название текущей страницы в верхней части редактора.
2. Выберите нужную страницу из выпадающего списка.
В разделе блока Store в поле Item type выберите пакет виртуальной валюты, который вы хотите продавать на сайте.

Настройте макет карточки товара.
После внесения всех необходимых изменений и подготовки сайта к запуску:
1. В правом верхнем углу редактора сайта нажмите Publish.
2. Отметьте страницы, которые нужно опубликовать.
3. Нажмите Publish.

Если публикация сайта недоступна, убедитесь, что выполнены все условия:

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

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

Получение данных о виртуальной валюте через API

Чтобы получить на клиенте каталог виртуальной валюты и пакетов виртуальной валюты, используйте методы подраздела Catalog из группы Виртуальные предметы и валюта.

Задача	Метод API
Получить виртуальную валюту по артикулу.	Передайте параметр `virtual_currency_sku` в метод API Получение виртуальной валюты по артикулу.
Получить список виртуальных валют.	Получение списка виртуальных валют.
Получить пакет виртуальной валюты по артикулу.	Передайте параметр `virtual_currency_package_sku` в метод API Получение пакета виртуальной валюты по артикулу.
Получить список пакетов виртуальной валюты.	Получение списка пакетов виртуальной валюты.

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

Способ доставки зависит от настроек интеграции в вашем проекте:

Если интегрирован PlayFab, виртуальная валюта и предметы автоматически начисляются в инвентарь пользователя в PlayFab.
Если вы используете собственную систему начислений, все виртуальные предметы и валюта начисляются на вашей стороне. Рекомендуем настроить обработчик вебхуков, чтобы получать данные о заказе на вашем бэкэнде. Необходимые данные приходят в вебхуке Успешная оплата заказа.

Подробности см. в разделе Настройка отслеживания статуса заказа.

Спасибо за обратную связь!

Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.

Последнее обновление: 15 мая 2026

Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

Содержание

Как это работает
Как настроить
Настройка в Личном кабинете
Настройка в вашем аккаунте
Настройка через API
Отображение виртуальной валюты в каталоге
Отображение через редактор сайта
Получение данных о виртуальной валюте через API
Начисление виртуальной валюты пользователям