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

- При вызове API методов управления инвентарем передайте в поле
platform
строку с платформой, для которой совершается покупка.
Пример
- html
1"platform": “playstation_network”
Ограничение количества доступных для покупки пакетов виртуальной валюты
Вы можете ограничить покупку пакетов виртуальной валюты. Например, вы можете продавать:
- ограниченное количество пакетов виртуальной валюты одному пользователю;
- приветственные пакеты виртуальной валюты, которые доступны к покупке только один раз.
Если пользователь превысил заданное ограничение, пакет виртуальной валюты не будет отображаться в каталоге.
Вы можете отобразить в интерфейсе максимальное доступное количество пакетов и оставшееся количество пакетов, которое доступно пользователю.
Чтобы задать ограничение на покупку, при создании пакета виртуальной валюты в Личном кабинете установите переключатель Ограничивать покупку пакетов виртуальной валюты пользователем в положение Вкл и укажите количество, доступное для покупки.
Вы можете получить информацию о пакетах виртуальной валюты, используя методы подраздела Catalog из группы методов Виртуальные предметы и валюта.
В ответе, кроме информации о пакете виртуальной валюты, вы получите следующую информацию:
- максимальное количество пакетов виртуальной валюты, которое может купить пользователь;
- оставшееся количество пакетов виртуальной валюты, доступное пользователю для покупки.
Подробнее о том, как настроить или обновить ограничения, вы можете прочитать в инструкции Ограничения для пользователя.
Для неавторизованного пользователя всегда отображается максимальное количество пакетов виртуальной валюты, которое он может купить. Чтобы отобразить пользователю оставшееся количество пакетов с учетом действующего ограничения, необходимо передавать данные авторизации пользователей на этапе запроса каталога пакетов виртуальной валюты с использованием методов подраздела Catalog из группы методов Виртуальные предметы и валюта.
Для корректного отображения количества пакетов виртуальной валюты, которое доступно пользователю, необходимо настроить аутентификацию.
- json
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 аннулирует все неоплаченные заказы с пакетом.
Ограничение времени отображения валюты и пакетов валюты в магазине
Вы можете указать период отображения виртуальной валюты и пакета валюты в магазине, чтобы:- поддерживать актуальность каталога в заданное время, например, во время праздничных распродаж;
- создать виртуальную валюту и пакеты валюты заранее, не отображая в каталоге;
- мотивировать пользователей к покупке с помощью таймера, который может отображаться рядом с виртуальной валютой или пакетом валюты.
Для кого подходит
Для партнеров, которые хотят настроить игровую экономику или монетизацию путем добавления в игру внутриигровой валюты и продажи за нее внутриигровых предметов.
Как настроить
Настройка виртуальной валюты
Вы можете настроить виртуальные валюты одним из следующих способов:Настройка через Личный кабинет
Настройка через методы API
Для настройки виртуальных валют используются методы подраздела Admin из группы методов Виртуальные предметы и валюта.Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.