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

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

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

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

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

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

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

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

Пример: Пакет содержит 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.

Нажмите Create manually и выберите Virtual currency из выпадающего списка.

В разделе General settings укажите следующее:
1. SKU
2. одну или несколько групп, к которым должен относиться товар (опционально)
3. Name
4. Short description
5. Extended description — чтобы добавить, включите соответствующий переключатель (опционально)

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

В разделе Price settings задайте цену или создайте бесплатный товар:
- Чтобы задать цену, выберите Paid item, включите переключатель Pricing in real currency и укажите цену. При необходимости настройте региональные цены.
- Чтобы создать бесплатный товар, выберите Free item.

Чтобы ограничить количество товаров, доступных для покупки:
1. Включите переключатель в разделе Limits и укажите количество.
2. Настройте частоту сброса лимита. Для этого выберите период из выпадающего списка:
  - Daily.
  - Weekly.
  - Monthly.
  - Custom interval. Интервал рассчитывается от даты начала отображения товара в магазине.
  - No regular refresh.
3. Настройте расписание сброса, указав параметры, которые соответствуют выбранному периоду.

По умолчанию товар скрывается из каталога после достижения лимита покупок. Если настроено автоматическое обновление лимитов, флажок Show item even after users reach the purchase limit позволяет сохранить видимость товара до начала следующего цикла обновлений.

Чтобы настроить ограничение по времени отображения товара (необязательно):
1. Включите переключатель в разделе Add specific display period.
2. Укажите часовой пояс, начало и конец периода.
Чтобы не указывать конец периода отображения товара, включите переключатель No end date.

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

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

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

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

Нажмите кнопку Create.
В открывшемся окне выберите статус предмета и нажмите Continue.

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

Откройте проект в Личном кабинете и перейдите в раздел 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.

Нажмите Create manually и выберите Virtual currency из выпадающего списка.

В разделе General settings укажите следующее:
1. SKU
2. одну или несколько групп, к которым должен относиться товар (опционально)
3. Name
4. Short description
5. Extended description — чтобы добавить, включите соответствующий переключатель (опционально)

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

Укажите виртуальную валюту в составе пакета и ее количество.
В разделе Price settings задайте цену или создайте бесплатный предмет:
- Чтобы задать цену, выберите Paid item, включите переключатель Pricing in real currency и/или Pricing in virtual currency и укажите цену. При необходимости настройте региональные цены.
- Чтобы создать бесплатный предмет, выберите Free item.

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

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

Чтобы ограничить количество предметов, доступных для покупки:
1. Включите переключатель в разделе Limits и укажите количество.
2. Настройте частоту сброса лимита. Для этого выберите период из выпадающего списка:
  - Daily.
  - Weekly.
  - Monthly.
  - Custom interval. Интервал рассчитывается от даты начала отображения предмета в магазине.
  - No regular refresh.
3. Настройте расписание сброса, указав параметры, которые соответствуют выбранному периоду.

Чтобы настроить ограничение времени отображения предмета (необязательно):
1. Включите переключатель в разделе Add specific display period.
2. Укажите часовой пояс, начало и конец периода.
Чтобы не указывать конец периода отображения предмета, включите переключатель No end date.

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

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

Нажмите кнопку Create.
В открывшемся окне выберите статус предмета и нажмите Continue.

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

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

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

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

Задача	Метод API
Создать виртуальную валюту.	Создать виртуальную валюту.
Получить виртуальную валюту.	Получить виртуальную валюту.
Получить список виртуальных валют.	Получить список виртуальных валют.
Обновить виртуальную валюту.	Обновить виртуальную валюту.
Удалить виртуальную валюту.	Удалить виртуальную валюту.
Ограничить количество виртуальной валюты, доступной для покупки.	В методах API Создать виртуальную валюту или Обновить виртуальную валюту укажите следующие параметры: `limits` — задает максимальное количество виртуальной валюты, доступной для покупки. `limits.recurrent_schedule` — определяет, как часто сбрасывается лимит.
Создать пакет виртуальной валюты.	Создать пакет виртуальной валюты.
Получить пакет виртуальной валюты.	Получить пакет виртуальной валюты.
Получить список пакетов виртуальной валюты.	Получить список пакетов виртуальной валюты.
Обновить пакет виртуальной валюты.	Обновить пакет виртуальной валюты.
Удалить пакет виртуальной валюты.	Удалить пакет виртуальной валюты.
Ограничить количество пакетов виртуальной валюты, доступных для покупки.	В методах 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.
Если вы используете собственную систему начислений, все виртуальные предметы и валюта начисляются на вашей стороне. Рекомендуем настроить обработчик вебхуков, чтобы получать данные о заказе на вашем бэкэнде. Необходимые данные приходят в вебхуке Successful payment for order.

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

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

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

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

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

Содержание

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