Создание группы

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

1. Откройте ваш проект в Личном кабинете.
2. В боковом меню перейдите в раздел Магазин.
3. В панели Виртуальные предметы нажмите:
   • Подключить — если вы не подключали виртуальные предметы раньше.
   • Настроить — если вы уже подключали виртуальные предметы.
4. В раскрывающемся меню выберите Создать группу.

5. Задайте необходимые параметры:
   • External ID — идентификатор группы в магазине, который применяется для управления группой виртуальных товаров через методы API. Должен быть уникальным для каждой группы.
   • Название группы.
6. Установите переключатель Показывать группу в магазине в положение Вкл, чтобы отображать предметы из этой группы в магазине.
7. Нажмите Создать группу.

Создание виртуальных предметов

1. Нажмите название созданной группы.
2. Нажмите Создать предмет.

3. Заполните информацию о предмете. Обязательные поля:
   • Артикул — уникальный ID предмета;
   • Название предмета;
   • Краткое описание предмета;
   • Цена в реальной валюте.
4. Установите переключатель Показать предмет в магазине в положение Вкл.
5. Нажмите Создать предмет.

Для дальнейшей работы вам потребуется артикул созданного предмета:

Для настройки виртуальных предметов используйте методы подраздела Admin из группы методов Virtual Items & Currency.

Для использования методов требуется базовая аутентификация. Передайте в запросе параметр Authorization:Basic <your_authorization_basic_key>, где <your_authorization_basic_key> — пара ID продавца:ключ API, закодированная по стандарту Base64. Значения параметров вы можете найти в Личном кабинете:

• ID продавца указан:
  • В разделе Настройки проекта > Вебхуки.
  • Разделе Настройки компании > Компания.
  • Aдресной строке браузера на любой странице Личного кабинета. URL-адрес имеет вид https://publisher.xsolla.com/​ID продавца/раздел Личного кабинета.

• Ключ API отображается в Личном кабинете только при создании и должен храниться на вашей стороне. Создать ключ можно в разделах:
  • Настройки компании > Ключи API;
  • Настройки проекта > Ключи API.

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