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

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

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

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

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

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

• в любом количестве;
• пакетом.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• При вызове API методов управления инвентарем передайте в поле platform строку с платформой, для которой совершается покупка.

Пример

"platform": “playstation_network”

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

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

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

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

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

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

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

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

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

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

{
  "items": [
    {
      "sku": "vc_package_1",
      "name": "VC Name first package",
      "groups": [],
      "attributes": [],
      "type": "bundle",
      "description": "VC Short Package Description",
      "image_url": "http://vc_package_image.png",
      "is_free": false,
      "price": {
        "amount": "2.0000",
        "amount_without_discount": "2.0000",
        "currency": "USD"
      },
      "bundle_type": "virtual_currency_package",
      "content": [
        {
          "description": "Big Rocket - short description",
          "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png",
          "sku": "big_rocket",
          "name": "Big Rocket",
          "type": "virtual_currency",
          "quantity": 100,
          "inventory_options": {
            "consumable": {
              "usages_count": 1
            },
            "expiration_period": null
          }
        }
      ],
      "virtual_prices": [],
      "limits": {
        "per_user": {
          "total": 5,
          "available": 5
          },
        "per_item": null
       },
      "can_be_bought": true
    },
    {
      "sku": "vc_package_3",
      "name": "VC Name third package",
      "groups": [],
      "attributes": [],
      "type": "bundle",
      "description": "VC Short Package Description",
      "image_url": "http://vc_package_image.png",
      "is_free": false,
      "price": {
        "amount": "4.0000",
        "amount_without_discount": "4.0000",
        "currency": "USD"
      },
      "bundle_type": "virtual_currency_package",
      "content": [
        {
          "description": "description",
          "image_url": "http://image.png",
          "sku": "shotgun_raider",
          "name": "SHOTGUN FOR TRUE RAIDERS",
          "type": "virtual_currency",
          "quantity": 200,
          "inventory_options": {
            "consumable": {
              "usages_count": 1
            },
            "expiration_period": null
          }
        }
      ],
      "virtual_prices": [],
      "limits": {
        "per_user": {
          "total": 5,
          "available": 5
          },
        "per_item": null
       },
      "can_be_bought": true
    }
  ]
}

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

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

"periods": [
      {
        "date_from": "2022-06-10T14:00:00+03:00",
        "date_until": "2022-06-30T14:00:00+03:00"
      },
       {
        "date_from": "2022-07-10T14:00:00+03:00",
        "date_until": "2022-07-30T14:00:00+03:00"
      },
       {
        "date_from": "2022-08-10T14:00:00+03:00",
        "date_until": "2022-08-30T14:00:00+03:00"
      }
]

"periods": [
      {
        "date_from": "2022-06-10T14:00:00+03:00",
        "date_until": "2022-06-30T14:00:00+03:00"
      },
       {
        "date_from": "2022-07-10T14:00:00+03:00",
        "date_until": "2022-07-30T14:00:00+03:00"
      },
       {
        "date_from": "2022-08-10T14:00:00+03:00",
        "date_until": "2022-08-30T14:00:00+03:00"
      }
]

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

• Для партнеров, которые хотят настроить игровую экономику или монетизацию путем добавления в игру внутриигровой валюты и продажи за нее внутриигровых предметов.
• Для партнеров, у которых подключен хотя бы один из следующих продуктов:
  • In-Game Store с настроенным модулем Виртуальные товары.
  • Buy Button с настроенным модулем Игровые ключи.

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

Предварительные действия

1. Зарегистрируйтесь в Личном кабинете Xsolla.
2. Перейдите к проекту.

3. Настройте модули для продукта In-Game Store или Buy Button.

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

• через Личный кабинет;
• через методы API.

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

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