Платежи / Получение токена
 На главную

Платежи

  • Руководство по интеграции

  • Тестирование

  • Возможности

  • Инструкции

  • Справочники

  • Получение токена

    Для открытия платежного интерфейса необходимо получить токен. Токен — это строка, в которой содержится зашифрованная информация об игре и пользователе. Вам необходимо реализовать получение токена, чтобы идентифицировать пользователя для начисления покупки.

    В серверной части вашего приложения реализуйте получение авторизационного токена. Для этого используйте HTTP POST-запрос с базовой HTTP-аутентифтикацией и передайте в теле запроса обязательные параметры.

    Справочник API
    Посмотреть полный список параметров.

    Время жизни токена — 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
    stringEmail-адрес пользователя для отправки чеков. Если параметр не передан в запросе, на платежной форме появляется обязательное поле для ввода 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).

    Пример запроса для получения авторизационного токена пользователя

    Copy
    Full screen
    Small screen

      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>"
            }
          }
        }'

      Пример авторизационного токена пользователя, который приходит в ответе

      Copy
      Full screen
      Small screen

        {
            "token": "1230OWrp0KF6uqvmN8jWuzLyoXMzxTyK_lc_en"
        }

        Прогресс интеграции
        Спасибо за обратную связь!
        Последнее обновление: 13 февраля 2023

        Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

        Сообщите о проблеме
        Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
        Укажите email-адрес, чтобы мы могли связаться с вами
        Спасибо за обратную связь!