Создание каталога
Создание виртуальных предметов на стороне Xsolla позволит вам настраивать региональные цены и ограничения, а также использовать систему акций и другие возможности Xsolla, которые регулярно добавляются и обновляются.
Создание группы
Перед настройкой виртуальных предметов создайте группы. Группы позволяют создавать многоуровневый каталог, а также управлять отображением предметов в магазине.
- Откройте проект в Личном кабинете.
- В боковом меню перейдите в раздел Store.
- В панели Виртуальные предметы нажмите:
- Подключить — если вы не подключали виртуальные предметы раньше.
- Настроить — если вы уже подключали виртуальные предметы.
- В раскрывающемся меню выберите Создать группу.
- Задайте необходимые параметры:
- External ID — ID группы в магазине, который применяется для управления группой виртуальных товаров через методы API. Должен быть уникальным для каждой группы.
- Название группы.
- Установите переключатель Показывать группу в магазине в положение Вкл, чтобы отображать предметы из этой группы в магазине.
- Нажмите Создать группу.
Создание виртуальных предметов
- Нажмите название созданной группы.
- Нажмите Создать предмет.
- Заполните информацию о предмете. Обязательные поля:
- Артикул — уникальный ID предмета;
- Название предмета;
- Краткое описание предмета;
- Цена в реальной валюте.
- Установите переключатель Показать предмет в магазине в положение Вкл.
- Нажмите Создать предмет.
Для дальнейшей работы вам потребуется артикул созданного предмета:
Для настройки виртуальных предметов используйте методы подраздела Admin из группы методов Виртуальные предметы и валюта.
Для использования методов требуется базовая аутентификация. Передайте в запросе параметр Authorization:Basic <your_authorization_basic_key>, где <your_authorization_basic_key> — пара ID продавца:ключ API, закодированная по стандарту Base64. Значения параметров вы можете найти в Личном кабинете:
- ID продавца указан:
- В разделе Настройки компании > Компания.
- Aдресной строке браузера на любой странице Личного кабинета. URL-адрес имеет вид
https://publisher.xsolla.com/<merchant ID>/<Publisher Account section>.
- Ключ API отображается в Личном кабинете только при создании и должен храниться на вашей стороне. Создать ключ можно в разделах:
- Настройки компании > Ключи API;
- Настройки проекта > Ключи API.
Подробная информация о работе с ключами API приведена в справочнике API.
Основные рекомендации:
- Сохраните созданный ключ API на вашей стороне. Вы можете посмотреть ключ API в Личном кабинете только один раз при его создании.
- Никому не сообщайте ваш ключ API, так как он дает доступ к управлению аккаунтом и проектами в Личном кабинете.
- Ключ API должен храниться на вашем сервере и никогда — в бинарных файлах или на фронтенде.
Если необходимый метод API не включает в себя path-параметр project_id, используйте для авторизации ключ API, который действует во всех проектах.
Для получения каталога виртуальных предметов на клиенте используйте методы подраздела Catalog из группы методов Виртуальные предметы и валюта. Для их использования авторизация не требуется.
Чтобы получить весь список предметов, независимо от их групп, используйте метод Получение списка виртуальных предметов. Чтобы получить список предметов определенной группы, передайте в метод Получение списка товаров по указанной группе параметр external_id.
Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.
