Получение токена
Для открытия платежного интерфейса необходимо получить токен. Токен — это строка, в которой содержится зашифрованная информация об игре и пользователе. Вам необходимо реализовать получение токена, чтобы идентифицировать пользователя для начисления покупки.
В серверной части вашего приложения реализуйте получение авторизационного токена. Для этого используйте HTTP POST-запрос с базовой HTTP-аутентифтикацией и передайте в теле запроса обязательные параметры.
Время жизни токена — 14 часов с момента последнего обращения к API Иксоллы. Реализуйте получение нового токена после истечения срока действия. Рекомендуется получать новый токен в фоновом режиме, без необходимости повторного входа пользователя в приложение.
Базовая HTTP-аутентификация
API Иксоллы использует базовую HTTP-аутентификацию. Все запросы к API должны содержать заголовок Authorization: Basic <your_authorization_basic_key>, где <your_authorization_basic_key> — пара ID продавца:ключ API, закодированная по стандарту Base64. Значения параметров вы можете найти в Личном кабинете:
- ID продавца указан:
- В разделе Настройки проекта > Вебхуки.
- Разделе Настройки компании > Компания.
- Aдресной строке браузера на любой странице Личного кабинета. URL-адрес имеет вид
https://publisher.xsolla.com/ID продавца/раздел Личного кабинета.
- Ключ API отображается в Личном кабинете только при создании и должен храниться на вашей стороне. Создать ключ можно в разделах:
- Настройки компании > Ключи API;
- Настройки проекта > Ключи API.
Подробная информация о работе с ключами API приведена в справочнике API.
Основные рекомендации:
- Сохраните созданный ключ API на вашей стороне. Вы можете посмотреть ключ API в Личном кабинете только один раз при его создании.
- Никому не сообщайте ваш ключ API, так как он дает доступ к управлению аккаунтом и проектами в Личном кабинете.
- Ключ API должен храниться на вашем сервере и никогда — в бинарных файлах или на фронтенде.
Тело запроса
В теле запроса передайте обязательные параметры:
| Параметр | Тип | Описание |
|---|---|---|
user.id | string | Уникальный идентификатор пользователя в вашей системе. |
user.email | string | Email-адрес пользователя для отправки чеков. Если параметр не передан в запросе, на платежной форме появляется обязательное поле для ввода email-адреса. |
settings.project_id | integer | Идентификатор игры в Иксолле. Вы можете найти эту информацию в Личном кабинете в разделе вашего проекта. |
Для улучшения пользовательского опыта, вы также можете передать следующие параметры:
| Параметр | Тип | Описание |
|---|---|---|
user.name | string | Никнейм пользователя, который отображается в чеке. |
settings.currency | string | Предпочтительная валюта платежа. |
settings.language | string | Язык платежного интерфейса. |
settings.ui.size | string | Размер платежного интерфейса. Может принимать значения: small (620 x 630 px), medium (740 x 760 px) и large (820 x 840 px). |
Пример запроса для получения авторизационного токена пользователя
curl -i -X POST \
-u 2340:ZHgbSDVP6LtAJVWu \
https://api.xsolla.com/merchant/v2/merchants/<merchant_id>/token \
-H 'Content-Type: application/json' \
-d '{
"settings": {
"currency": "USD",
"language": "en",
"project_id": <project_id>,
"ui": {
"size": "medium"
}
},
"user": {
"email": {
"value": "<user_email>"
},
"id": {
"value": "<user_id>"
},
"name": {
"value": "<user_name>"
}
}
}'Пример авторизационного токена пользователя, который приходит в ответе
{
"token": "1230OWrp0KF6uqvmN8jWuzLyoXMzxTyK_lc_en"
}Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.
