Создание каталога
Создание виртуальных предметов на стороне Xsolla позволит вам настраивать региональные цены и ограничения, а также использовать систему акций и другие возможности Xsolla, которые регулярно добавляются и обновляются.
Создание группы
Перед настройкой виртуальных предметов создайте группы. Группы позволяют создавать многоуровневый каталог, а также управлять отображением предметов в магазине.
- Откройте проект в Личном кабинете.
- В боковом меню перейдите в раздел Store.
- В панели Виртуальные предметы нажмите:
- Подключить — если вы не подключали виртуальные предметы раньше.
- Настроить — если вы уже подключали виртуальные предметы.
- В раскрывающемся меню выберите Создать группу.
- Задайте необходимые параметры:
- External ID — ID группы в магазине, который применяется для управления группой виртуальных товаров через методы API. Должен быть уникальным для каждой группы.
- Название группы.
- Установите переключатель Показывать группу в магазине в положение Вкл, чтобы отображать предметы из этой группы в магазине.
- Нажмите Создать группу.
Создание виртуальных предметов
- Нажмите название созданной группы.
- Нажмите Создать предмет.
- Заполните информацию о предмете. Обязательные поля:
- Артикул — уникальный ID предмета;
- Название предмета;
- Краткое описание предмета;
- Цена в реальной валюте.
- Установите переключатель Показать предмет в магазине в положение Вкл.
- Нажмите Создать предмет.
Для дальнейшей работы вам потребуется артикул созданного предмета:
Для настройки виртуальных предметов используйте методы подраздела
Для использования методов требуется базовая аутентификация. Передайте в запросе параметр 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, который действует во всех проектах.
Для получения каталога виртуальных предметов на клиенте используйте методы подраздела
Чтобы получить весь список предметов, независимо от их групп, используйте метод external_id.
Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.
