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

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

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

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

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

Варианты продажи валюты

Продажа валюты возможна в двух видах: 

Продажа любого количества валюты

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

Пакеты виртуальной валюты

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

Пример: “Золотой пакет” содержит 100 золотых монет и стоит 90$ при стоимости золота 1$ за монету.

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

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

Доставка валюты

Виртуальная валюта доставляется:
  • В инвентарь (способ по умолчанию). Пакет виртуальной валюты перед доставкой распаковывается, и в инвентарь игрока начисляется виртуальная валюта из его состава.
  • В PlayFab, если настроена интеграция.
Примечание
Если логика внутриигрового магазина реализована на ваших серверах, вы можете настроить вебхук о покупке товаров.

Премиум-валюта

Премиум-валюта — это виртуальная валюта, которая привязана к платформе, где осуществляется покупка, и которая продается только за реальную валюту.

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

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

Чтобы настроить хранение премиум-валюты раздельно по платформам:

  • Установите переключатель Премиум-валюта в положение Вкл.

Пример

Copy
Full screen
Small screen
1"platform": “playstation_network”

Ограничение количества доступных для покупки пакетов виртуальной валюты

Вы можете ограничить покупку пакетов виртуальной валюты. Например, вы можете продавать:

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

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

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

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

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

В ответе, кроме информации о пакете виртуальной валюты, вы получите следующую информацию:

  • максимальное количество пакетов виртуальной валюты, которое может купить пользователь;
  • оставшееся количество пакетов виртуальной валюты, доступное пользователю для покупки.

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

Примечание

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

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

Пример ответа на вебхук с атрибутами пользователей:
Copy
Full screen
Small screen
 1{
 2  "items": [
 3    {
 4      "sku": "vc_package_1",
 5      "name": "VC Name first package",
 6      "groups": [],
 7      "attributes": [],
 8      "type": "bundle",
 9      "description": "VC Short Package Description",
10      "image_url": "http://vc_package_image.png",
11      "is_free": false,
12      "price": {
13        "amount": "2.0000",
14        "amount_without_discount": "2.0000",
15        "currency": "USD"
16      },
17      "bundle_type": "virtual_currency_package",
18      "content": [
19        {
20          "description": "Big Rocket - short description",
21          "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png",
22          "sku": "big_rocket",
23          "name": "Big Rocket",
24          "type": "virtual_currency",
25          "quantity": 100,
26          "inventory_options": {
27            "consumable": {
28              "usages_count": 1
29            },
30            "expiration_period": null
31          }
32        }
33      ],
34      "virtual_prices": [],
35      "limits": {
36        "per_user": {
37          "total": 5,
38          "available": 5
39          },
40        "per_item": null
41       },
42      "can_be_bought": true
43    },
44    {
45      "sku": "vc_package_3",
46      "name": "VC Name third package",
47      "groups": [],
48      "attributes": [],
49      "type": "bundle",
50      "description": "VC Short Package Description",
51      "image_url": "http://vc_package_image.png",
52      "is_free": false,
53      "price": {
54        "amount": "4.0000",
55        "amount_without_discount": "4.0000",
56        "currency": "USD"
57      },
58      "bundle_type": "virtual_currency_package",
59      "content": [
60        {
61          "description": "description",
62          "image_url": "http://image.png",
63          "sku": "shotgun_raider",
64          "name": "SHOTGUN FOR TRUE RAIDERS",
65          "type": "virtual_currency",
66          "quantity": 200,
67          "inventory_options": {
68            "consumable": {
69              "usages_count": 1
70            },
71            "expiration_period": null
72          }
73        }
74      ],
75      "virtual_prices": [],
76      "limits": {
77        "per_user": {
78          "total": 5,
79          "available": 5
80          },
81        "per_item": null
82       },
83      "can_be_bought": true
84    }
85  ]
86}
Примечание

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

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

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

Ограничение времени отображения валюты и пакетов валюты в магазине

Вы можете указать период отображения виртуальной валюты и пакета валюты в магазине, чтобы:
  • поддерживать актуальность каталога в заданное время, например, во время праздничных распродаж;
  • создать виртуальную валюту и пакеты валюты заранее, не отображая в каталоге;
  • мотивировать пользователей к покупке с помощью таймера, который может отображаться рядом с виртуальной валютой или пакетом валюты.
Примечание
При создании интерфейса каталога с помощью Site Builder таймер будет отображаться автоматически. При создании каталога в собственном интерфейсе таймер необходимо реализовать самостоятельно.

Для кого подходит

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

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

Настройка виртуальной валюты

Вы можете настроить виртуальные валюты одним из следующих способов:

Настройка через Личный кабинет

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

Для настройки виртуальных валют используются методы подраздела Admin из группы методов Виртуальные предметы и валюта.
Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Последнее обновление: 2 апреля 2025

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

Сообщите о проблеме
Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
Укажите email-адрес, чтобы мы могли связаться с вами
Спасибо за обратную связь!
Не получилось отправить ваш комментарий
Попробуйте еще раз позже или напишите нам на doc_feedback@xsolla.com.