Общие вопросы
Настройки проекта
Нужно ли создавать отдельные проекты для каждой среды (QA, staging, production)?
Для тестирования рекомендуется использовать отдельные проекты, чтобы изменения не затрагивали среду production.
Я разработчик мобильных игр. Что мне указать в качестве сайта в настройках проекта?
Укажите URL-адрес лендинга игры или сайт вашей компании.
Как я могу добавить в Личный кабинет других сотрудников компании?
Перейдите в Личный кабинет и в разделе Настройки компании > Пользователи нажмите Пригласить пользователя.
Где я могу найти ID проекта?
Откройте проект в Личном кабинете и перейдите в раздел Настройки проекта > Общие настройки.
Где я могу найти ID продавца?
Откройте Личный кабинет и перейдите в раздел Настройки компании > Компания.
В чем разница между секретным ключом, ключом проекта и ключом API?
Секретный ключ и ключ проекта — это одно и то же. Он используется для формирования цифровой подписи, необходимой для проведения платежей. JSON-тело запроса конкатенируется с этим ключом, а затем результат хешируется при помощи SHA-1.
Ключ API используется для запросов к серверу Xsolla. Ключ API должен храниться на вашем сервере и никогда — в бинарных файлах или на фронтенде. Подробная информация о работе с ключами API приведена в справочнике API.
В чем разница между URL-адресом вебхука и URL-адресом возврата?
URL-адрес вебхука — это адрес вашего вебхук-сервера, на который приходят оповещения. URL-адрес возврата — это адрес, на который перенаправляется пользователь после совершения платежа.
Где мне найти ключ API?
Ключ API отображается в Личном кабинете только при создании и должен храниться на вашей стороне. Создать ключ можно в разделах:
Подробная информация о работе с ключами API приведена в справочнике API.
Основные рекомендации:
- Сохраните созданный ключ API на вашей стороне. Вы можете посмотреть ключ API в Личном кабинете только один раз при его создании.
- Никому не сообщайте ваш ключ API, так как он дает доступ к управлению аккаунтом и проектами в Личном кабинете.
- Ключ API должен храниться на вашем сервере и никогда — в бинарных файлах или на фронтенде.
Если необходимый метод API не включает в себя path-параметр project_id, используйте для авторизации ключ API, который действует во всех проектах.
API и вебхуки
Какие API доступны у Xsolla?
Вы можете использовать следующие API:
Как начать работать с Xsolla API?
Изучите вводную информацию.
Где я могу найти информацию о работе с вебхуками?
Какие IP-адреса необходимо добавить в список разрешений для настройки вебхуков?
Список IP-адресов, с которых поступают вебхуки, приведен в документации вебхуков.
Необходимо ли для вебхуков использовать HTTPS?
Да.
Почему оповещение от Xsolla не пришло на URL-адрес вебхука?
Убедитесь, что ваш вебхук-сервер поддерживает необходимые виды HTTP-запросов (POST, GET).
Почему вебхуки не приходят на мое мобильное приложение?
Вебхуки отправляются только на один URL-адрес — тот, что указан в настройках проекта. Будучи сервер-серверными, они не могут уходить сразу на несколько URL-адресов. Если вы хотите получать оповещения в вашей игре, на сайте или мобильном приложении, реализуйте отправку вебхуков на собственном сервере, чтобы пересылать данные между Xsolla и игрой.
Почему в вебхук-запросе нет заголовка Authorization?
Чтобы исправить эту ошибку, измените файлы .htaccess или httpd.conf в Apache. Подробную инструкцию можно найти в документации SDK.
SDK
Какие SDK поддерживает Xsolla?
Xsolla поддерживает следующие SDK:
Где я могу найти подробную информацию о каждом SDK?
Перейдите в документацию SDK и выберите нужный вам раздел.
У вас есть SDK под Node.JS/C#/Ruby/Java/ASP и т. п.?
Сейчас доступны SDK под PHP и Android, но вы можете создать собственный SDK под любой язык/платформу, где можно отправлять HTTPS-запросы.
Автоматические уведомления о важных изменениях в настройках Личного кабинета
Как только в вашем проекте изменяются настройки, которые могут повлиять на прием платежей и работу ваших систем, Xsolla отправляет уведомления об этих изменениях. Уведомления по электронной почте получают пользователи, у которых указана роль Владелец в Личном кабинете в разделе Настройки компании > Пользователи. Уведомления отправляются с задержкой до 1 минуты.
| Раздел в Личном кабинете | События для уведомлений |
|---|---|
| Настройки компании |
|
| Настройки проекта |
|
| Store | Изменения в настройках игровых ключей, виртуальной валюты и виртуальных предметов:
|
Журнал активности
Журнал активности отображает основные действия пользователей вашей компании, связанные с работой ключевых сервисов Xsolla. Он фиксирует HTTP-запросы к API, которые отправляются напрямую или выполняются через интерфейс Личного кабинета.
Просмотр журнала активности доступен в Личном кабинете в разделе Настройки компании > Активность.
Раздел доступен пользователям Личного кабинета, для которых выполняются следующие условия:
- Роль Владелец.
- Если в аккаунте включено ограничение доступа по проектам, пользователь имеет доступ ко всем проектам.
Основные возможности:
- Фильтрация данных по периоду времени и email-адресу пользователя, инициировавшего запрос к API.
- Экспорт журнала активности в CSV-файл с учетом примененного фильтра.
- В журнале активности доступны данные за последние 2 года. Чтобы получить данные старше 2 лет, обратитесь к персональному менеджеру проекта или напишите на csm@xsolla.com.
- Экспорт данных доступен за период не больше года. Чтобы получить данные за более длительный срок, разбейте его на периоды не более 1 года и выполните экспорт для каждого периода отдельно. Например, экспортируйте данные за 2024 и 2025 годы отдельными файлами.
Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.
