Создание и настройка проекта в Личном кабинете
Создание проекта в Личном кабинете
Личный кабинет — основной инструмент для настройки возможностей Xsolla, а также для работы с аналитикой и транзакциями.
Указанные на этапе регистрации данные о компании и вашем приложении будут использоваться для формирования рекомендаций с подходящими для вас решениями и создания черновика договора с Xsolla. Вы сможете изменить данные позже, но указание при регистрации верных данных ускорит процесс согласования договора.
Чтобы создать проект:
- Зарегистрируйтесь в Личном кабинете.
Правила для формирования пароля
Пароль от Личного кабинета должен содержать не менее:
- 8 символов;
- одной цифры;
- одной прописной буквы латинского алфавита;
- одной строчной буквы латинского алфавита.
Для обеспечения безопасности пароля рекомендуется:
- менять пароль не реже одного раза в 90 дней;
- использовать новый пароль, который не совпадает с последними 4 паролями вашей учетной записи;
- использовать уникальный пароль, который не совпадает с паролями в других сервисах;
- не хранить пароль в легкодоступных местах;
- использовать менеджеры паролей для хранения пароля.
Личный кабинет использует двухфакторную аутентификацию и отправляет код подтверждения при каждой попытке аутентификации.
- Укажите основную информацию для создания аккаунта:
- Ваши имя и фамилию.
- Вашу роль в компании.
- Название компании. Если вы регистрируетесь как физическое лицо, укажите полностью ваши имя и фамилию.
- Ссылку на подробную информацию о вас и вашей игре или продукте (опционально).
- Вашу страну или регион.
- Нажмите Далее.

- Чтобы автоматически создать ваш первый проект, укажите основную информацию о нем:
- Выберите тип проекта: Игра, Игровая платформа или Другое.
- Введите название проекта на английском языке.
- Выберите одну или несколько платформ релиза.
- Выберите способы монетизации, которые вы используете или собираетесь использовать.
- Выберите стадию разработки.
- Если тип вашего проекта — Игра, выберите ее жанр и игровой движок.
- Добавьте ссылку на игру или продукт (опционально).
- Нажмите Завершить.

После создания проекта вы будете перенаправлены на страницу компании, где в боковом меню отобразится созданный проект:
- Нажмите на его название, чтобы перейти к дальнейшей интеграции продуктов и решений Xsolla.
- Перейдите в раздел Настройки проекта, чтобы добавить дополнительные языки и названия проекта на этих языках (опционально).

Если у вас несколько игр или продуктов, добавьте проект для каждой из них. Для этого на странице компании в боковом меню нажмите Создать проект и укажите необходимую информацию.

В процессе интеграции вам потребуется ID проекта. Вы можете найти его в Личном кабинете рядом с названием проекта.

Настройка аутентификации пользователя
Xsolla позволяет настроить множество способов аутентификации пользователей. Ниже приведены инструкции по наиболее быстрому способу интеграции и настройки — использованию готового виджета для аутентификации пользователя по одноразовому коду или через социальную сеть.
Позже вы сможете изменить способ аутентификации пользователя или использовать другой способ интеграции.
Xsolla предоставляет стандартные шаблоны для виджета авторизации. Их внешний вид и наполнение определяются способом авторизации, выбранным для проекта, и настройками кастомизации виджета в Личном кабинете.
Стандартный вид виджета для аутентификации по одноразовому коду или через социальные сети:

Чтобы настроить вариант авторизации в Личном кабинете:
- Откройте проект в Личном кабинете.
- В боковом меню нажмите Игроки > Авторизация.
- Нажмите Создать вариант авторизации.
- Выберите Стандартный вариант авторизации и нажмите Создать и настроить. Подождите, пока вариант авторизации не будет создан. Затем вы увидите страницу настроек варианта авторизации.
- В блоке Способы авторизации выберите Авторизация без пароля.
- Нажмите Настроить.
- Настройте авторизацию по одноразовому коду:
- В блоке Авторизация без пароля выберите раздел Настройки callback URL.
- В поле Callback URL добавьте URL-адрес, на который перенаправляются пользователи после их успешной аутентификации.
- Нажмите Сохранить изменения.
- Настройте OAuth 2.0-клиент:
- В цепочке навигации нажмите название вашего варианта авторизации, чтобы вернуться на страницу варианта авторизации.
- Перейдите к блоку Безопасность и выберите раздел OAuth 2.0 аутентификация.
- Нажмите Добавить клиент OAuth 2.0.
- Выберите тип аутентификации Публичная.
- Укажите URI переадресации OAuth 2.0 — путь в приложении, на который пользователь будет перенаправлен после успешной авторизации, аутентификации, подтверждения электронной почты или сброса пароля. Можно указать несколько допустимых путей.
- Для настольных и веб-приложений путь должен содержать префикс
https://
. По умолчанию в SDK используется путьhttps://login.xsolla.com/api/blank
. Укажите его или собственный URI-адрес. - Для Android-приложения укажите путь в формате
app://xlogin.<ANDROID_PACKAGE_NAME>
, где<ANDROID_PACKAGE_NAME>
— название пакета Android-приложения. - Для iOS-приложения укажите путь в формате
app://xlogin.<BUNDLE_ID>
где<BUNDLE_ID>
— идентификатор iOS-приложения.
- Нажмите Подключить.
- Настройте аутентификацию через социальные сети (опционально):
- Нажмите название вашего варианта авторизации в цепочке навигации, чтобы вернуться на страницу варианта авторизации.
- Перейдите к блоку Аутентификация и выберите раздел Авторизация через социальные сети.
- Подключите социальные сети, через которые пользователи смогут регистрироваться и входить в приложение. Это можно сделать одним из следующих способов:
- Чтобы подключить нужную социальную сеть, нажмите значок ⚙ и выберите пункт Подключить.
- Чтобы подключить сразу несколько социальных сетей, выберите нужные панели (рамки панелей станут зелеными). Затем в раскрывающемся меню Управление выберите пункт Подключить.
- Чтобы подключить сразу все доступные социальные сети, нажмите Выбрать все. Затем в раскрывающемся меню Управление выберите пункт Подключить.
- Нажмите Сохранить изменения.
Чтобы протестировать настройки виджета, нажмите Проверить виджет в левой части экрана и авторизуйтесь
В процессе интеграции вам понадобятся:
- ID варианта авторизации, который можно найти в проекте в Личном кабинете, в разделе Игроки > Авторизация > Дашборд.
- ID клиента OAuth 2.0, который можно найти в проекте в Личном кабинете в разделе Игроки > Авторизация > проект авторизации > Безопасность > OAuth 2.0 аутентификация.
Создание предметов в Личном кабинете
Вам потребуется создать каталог товаров на стороне Xsolla. Вы можете добавить товары вручную или импортировать их из App Store, Google Play или PlayFab. При импорте из Google Play можно импортировать не более 100 предметов за раз.
В рамках этой инструкции приведены шаги по базовой настройке виртуального предмета. Позже вы сможете дополнить свой каталог другими товарами (виртуальными валютами, бандлами, игровыми ключами), создать группы товаров, настроить акционные кампании, региональные цены и т. д.
Чтобы добавить в каталог виртуальный предмет с базовыми настройками:
- В проекте в Личном кабинете перейдите в раздел Каталог товаров > Виртуальные предметы.
- В раскрывающемся меню выберите Создать предмет.
- Задайте базовые настройки предмета в следующих полях:
- Изображение (опционально).
- Артикул (уникальный ID предмета).
- Название предмета.
- Описание (опционально).
- Задайте цену предмета:
- Установите переключатель Цены в реальной валюте в положение Вкл.
- В поле Цена в реальной валюте измените валюту (опционально) и укажите цену предмета.
- Если вы изменили валюту в поле Цена в реальной валюте, укажите эту же валюту в поле Валюта по умолчанию.
- Измените статус предмета на Доступен.
- Нажмите Создать предмет.
Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.