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

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

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

Чтобы настроить виртуальную валюту через Личный кабинет:

1. В проекте в Личном кабинете перейдите в раздел Каталог товаров > Все товары.
2. Нажмите Добавить и в раскрывающемся списке выберите Виртуальная валюта.

3. Добавьте:
   1. изображение (опционально);
   2. артикул;
   3. название виртуальной валюты.
4. Чтобы настроить отображение виртуальной валюты в магазине, выберите соответствующий статус.

5. Чтобы задать цену, нажмите Настроить цены и укажите цену в реальной валюте. При необходимости настройте региональные цены.
6. Настройте атрибуты для предмета одним из следующих способов (опционально):

1. 1. Добавьте атрибуты и их значения в формате JSON.

1. 2. Создайте атрибуты и их значения вручную и настройте их связь с товарами.

7. Проверьте настройки и нажмите Создать валюту.

1. В проекте в Личном кабинете перейдите в раздел Каталог товаров > Все товары.
2. Нажмите Добавить и в раскрывающемся списке выберите Пакет виртуальной валюты.

3. Добавьте:
   1. изображение (опционально);
   2. артикул;
   3. группу, содержащую этот пакет в магазине;
   4. название;
   5. краткое описание (опционально).
4. Чтобы настроить отображение виртуальной валюты в магазине, выберите соответствующий статус.

5. Укажите виртуальную валюту в составе пакета и ее количество.
6. Задайте цены или создайте бесплатный предмет в поле Платно или бесплатно:

1. • Чтобы создать бесплатный предмет, выберите Бесплатный предмет.

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

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

1. 1. В раскрывающемся списке выберите период:
      • Каждый день.
      • Каждую неделю.
      • Каждый месяц.
      • Настроить интервал. Интервал рассчитывается от даты начала периода показа пакета в магазине.
      • Без регулярного обновления.

1. 2. Задайте расписание обновления, указав параметры, соответствующие периоду.

9. Чтобы настроить ограничение времени отображения пакета (опиционально):

1. 1. В поле Показывать товар в магазине выберите Ограниченное время.

1. 2. Укажите часовой пояс, начало и конец периода.

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

10. Настройте атрибуты для предмета одним из следующих способов (опционально):

1. 1. Добавьте атрибуты и их значения в формате JSON.

1. 2. Создайте атрибуты и их значения вручную и настройте их связь с товарами.

11. Проверьте настройки и нажмите Создать пакет.

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

Подробная информация о виртуальных предметах и их видах доступна в разделе Виртуальные предметы.

1. В проекте в Личном кабинете перейдите в раздел Каталог товаров > Все товары.
2. Нажмите Добавить и в раскрывающемся списке выберите Виртуальный предмет.

3. Добавьте:
   • изображение (опционально);
   • артикул;
   • группу, содержащую этот предмет в магазине;
   • название;
   • краткое описание (опционально).
4. Чтобы настроить отображение предмета в магазине, выберите соответствующий статус.

5. Задайте цены или создайте бесплатный предмет в поле Платно или бесплатно:

1. • Чтобы создать бесплатный предмет, выберите Бесплатный предмет.

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

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

1. 1. В раскрывающемся списке выберите период:
      • Каждый день.
      • Каждую неделю.
      • Каждый месяц.
      • Настроить интервал. Интервал рассчитывается от даты начала периода показа предмета в магазине.
      • Без регулярного обновления.

1. 2. Задайте расписание обновления, указав параметры, соответствующие периоду.

8. Чтобы настроить ограничение времени отображения предмета (опционально):

1. 1. В поле Показывать товар в магазине выберите Ограниченное время.

1. 2. Укажите часовой пояс, начало и конец периода.

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

9. Настройте атрибуты для предмета одним из следующих способов (опционально):

1. 1. Добавьте атрибуты и их значения в формате JSON.

1. 2. Создайте атрибуты и их значения вручную и настройте их связь с товарами.

10. Проверьте настройки и нажмите Создать предмет.

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

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

Подробная информация о бандлах доступна в разделе Бандлы.

Чтобы создать бандл:

1. В проекте в Личном кабинете перейдите в раздел Каталог товаров > Все товары.
2. Нажмите Добавить и в раскрывающемся списке выберите Бандл.

3. Задайте необходимые параметры:
   • изображение (опционально);
   • артикул;
   • одну или несколько групп, которым должен принадлежать бандл;
   • название бандла;
   • описание бандла (опционально).
4. Настройте атрибуты для бандла одним из следующих способов (опционально):
   • Добавьте атрибуты и их значения в формате JSON.
   • Создайте атрибуты и их значения вручную и настройте их связь с товарами.
5. Нажмите Далее.
6. Если вы используете персонализацию на стороне партнера, выберите тип бандла — стандартный или динамический. Для бандлов динамического типа вы можете не создавать товары на стороне Xsolla, а передавать содержимое бандла, сформированное на стороне вашего сервера в момент запроса каталога. Если персонализация на стороне партнера не подключена, переключатель с выбором типа бандла не отображается и создается бандл стандартного типа.

7. Добавьте товары в бандл:
   1. Выберите тип товара.
   2. Укажите один или несколько артикулов товаров, входящих в бандл.
   3. Задайте количество для каждого артикула.

8. Нажмите Далее.
9. Настройте цену бандла в поле Платно или бесплатно:
   • Чтобы создать бесплатный бандл, выберите Бесплатный бандл.
   • Чтобы задать цену, выберите Платный бандл и укажите цену в реальной или виртуальной валюте. Бандл с нулевой ценой создать нельзя. При необходимости настройте региональные цены.
10. Чтобы ограничить количество бандлов, доступное для покупки, активируйте переключатель Ограничивать покупку бандлов пользователем и введите необходимое число.

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

12. Нажмите Далее.

13. Настройте отображение бандла в магазине:
    1. Выберите статус.
    2. Настройте ограничение времени отображения бандлов (опционально): укажите часовой пояс, начало и конец периода отображения. Чтобы не указывать конец периода отображения бандла, установите флажок Без даты окончания.

14. Нажмите Далее.
15. Проверьте все настройки и нажмите Сохранить.

Вы можете настроить план подписки через Личный кабинет или c помощью метода API Создание плана.

Чтобы настроить план в Личном кабинете:

1. Перейдите в раздел Каталог товаров > Подписки.
2. На вкладке Планы подписки нажмите Создать план подписки.

3. Выберите тип плана и настройте его:
   • Обычный план — с регулярными платежами.
   • Бесконечный план — с разовой оплатой и неограниченным периодом действия.
   • Сезонный пропуск — с разовой оплатой и ограниченным периодом действия.

Настройка обычного плана

1. Укажите:
   1. Название плана.
   2. Описание (опционально). Описание плана отображается в платежном интерфейсе при покупке подписки.

2. Нажмите Далее.
3. Выберите один из вариантов стоимости подписки:
   • Обычная — сумма регулярного списания указывается вручную.
   • С дополнительной платой — сумма регулярного списания, а также сумма дополнительной платы при первом списании указывается вручную. Используйте эту настройку, если вы хотите взимать плату с подписчика для покрытия дополнительных расходов, таких как подключение лицензии, настройка системы, обучение пользователя или предоставление консультации. Первый платеж при этом будет включать дополнительную плату, остальные платежи будут равны сумме, регулярного списания.

• • Равная сумме первого платежа — сумма регулярного списания равна первому платежу. Стоимость подписки и тип валюты передаются в параметрах purchase.checkout.amount и purchase.checkout.currency при открытии платежного интерфейса. Используйте этот вариант, если вы хотите управлять ценами на своей стороне и иметь возможность устанавливать стоимость подписки для конкретного пользователя.

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

• 1. В поле Валюта и Цена выберите необходимую валюту и укажите значение цены подписки. Для подписки с дополнительной платой также укажите значение дополнительной платы в соответствующем поле.

• 2. Нажмите +, чтобы добавить цены в других валютах.

• 3. Укажите валюту по умолчанию.

5. Определите расчетный период: 
   1. Укажите периодичность платежа.
   2. Укажите количество дней пробного периода, когда подписка может использоваться без оплаты. Для создания плана без пробного периода укажите значение 0.

6. Укажите параметры для единовременного платежа — типа продления подписки, при котором списания осуществляются пользователем через ссылку на оплату, полученную по электронной почте:
   1. Напоминание об окончании подписки. Укажите количество дней до даты истечения подписки, за которое необходимо уведомлять пользователя. Если значение равно 6 или выше, пользователь получит дополнительное оповещение за день до окончания срока действия подписки. Если вы не хотите отправлять уведомления, укажите значение 0.
   2. Количество дней льготного периода, когда пользователь сможет продолжать пользоваться подпиской после окончания ее срока, имея возможность ее продлить. Для создания плана без льготного периода укажите значение 0.

7. Укажите параметры для автоматического платежа — типа продления подписки, при котором списания происходят автоматически с сохраненного платежного аккаунта, без участия пользователя:
   1. Напоминание об окончании подписки.
   2. Количество попыток списания после первой неудачной попытки списания средств. Система будет повторять попытки один раз в день.

8. Нажмите Далее.

9. Нажмите Создать.

Настройка бесконечного плана

1. Укажите:
   1. Название плана.
   2. Описание (опционально). Описание плана отображается в платежном интерфейсе при покупке подписки.

2. Нажмите Далее.
3. Выберите один из вариантов стоимости подписки:
   • Обычная — сумма регулярного списания указывается вручную.
   • Равная сумме первого платежа — сумма регулярного списания равна первому платежу. Стоимость подписки и тип валюты передаются в параметрах purchase.checkout.amount и purchase.checkout.currency при открытии платежного интерфейса. Используйте этот вариант, если вы хотите управлять ценами на своей стороне и иметь возможность устанавливать стоимость подписки для конкретного пользователя.

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

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

• 1. В поле Валюта и Цена выберите необходимую валюту и укажите стоимость подписки.

• 2. Нажмите +, чтобы добавить цены в других валютах.

• 3. Укажите валюту по умолчанию.

6. Нажмите Далее.

7. Нажмите Создать.

Настройка сезонного пропуска

1. Укажите:
   1. Название плана.
   2. Период действия сезонного пропуска.
   3. Описание (опционально). Описание плана отображается в платежном интерфейсе при покупке подписки.

2. Нажмите Далее.
3. Выберите один из вариантов стоимости подписки:
   • Обычная — сумма регулярного списания указывается вручную.
   • Равная сумме первого платежа — сумма регулярного списания равна первому платежу. Стоимость подписки и тип валюты передаются в параметрах purchase.checkout.amount и purchase.checkout.currency при открытии платежного интерфейса. Используйте этот вариант, если вы хотите управлять ценами на своей стороне и иметь возможность устанавливать стоимость подписки для конкретного пользователя.

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

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

• 1. В поле Валюта и Цена выберите необходимую валюту и укажите стоимость подписки.

• 2. Нажмите +, чтобы добавить цены в других валютах.

• 3. Укажите валюту по умолчанию.

6. Нажмите Далее.

7. Нажмите Создать.