Как реализовать продажу виртуальной валюты Metaframe в собственном интерфейсе

Вы можете продавать виртуальную валюту, не используя виджет Metaframe. Например, если вы хотите реализовать собственный интерфейс магазина или использовать другой сервис авторизации. Для этого вам потребуется реализовать логику покупки, автопополнения и отображения баланса виртуальной валюты с помощью Metaframe API.

Предварительные действия

Перед тем как начать, выполните необходимые настройки проекта:

1. Создайте проект.
2. Создайте пакеты виртуальной валюты в Личном кабинете.
3. Получите необходимые идентификаторы и секретный ключ. Для этого обратитесь к персональному менеджеру проекта, напишите на csm@xsolla.com или integration@xsolla.com. Предоставьте следующие данные из Личного кабинета:

• ID продавца, который вы можете найти:
  • Рядом с названием вашей компании.
  • В разделе Настройки компании > Компания.
  • Aдресной строке браузера на любой странице Личного кабинета. URL-адрес имеет вид: https:​//publisher.xsolla.com/ID продавца/раздел Личного кабинета.

• ID проекта, который вы можете найти рядом с названием проекта.

• Секретный ключ проекта для подписи вебхуков, который вы можете найти в разделе Настройка проекта > Вебхуки.

• Ключ API, который отображается в Личном кабинете только при создании и должен храниться на вашей стороне. Создать ключ можно в разделах:
  • Настройки компании > Ключи API;
  • Настройки проекта > Ключи API.

Команда Xsolla сообщит вам следующие данные, необходимые для дальнейшей настройки:

• ID хоста;
• ID клиента OAuth 2.0 аккаунта Xsolla;
• секретный ключ клиента OAuth 2.0 аккаунта Xsolla.

Получение серверного токена

Серверный токен требуется для получения авторизационного токена пользователя и для автопополнения.

В серверной части вашего приложения реализуйте метод для получения серверного JSON Web Token (JWT) с использованием запроса Generate JWT. Запрос должен содержать следующие параметры:

• grant_type — тип JWT, передайте значение client_credentials;
• client_secret — секретный ключ OAuth 2.0-клиента, который вы получили от Xsolla;
• client_id — ID OAuth 2.0-клиента, который вы получили от Xsolla.

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

Авторизационный токен пользователя требуется для формирования платежного токена и для запроса баланса виртуальной валюты пользователя.

Если вы используете собственную систему авторизации, вы можете получить подходящий авторизационный токен используя:

• авторизационный токен социальной сети;
• custom ID —  ID пользователя, сформированный на вашем сервере.

Получение токена при авторизации через социальные сети

1. Настройте  в Личном кабинете авторизацию пользователя через социальную сеть:

1. 1. Откройте проект в Личном кабинете.
   2. В боковом меню нажмите Login.
   3. Нажмите Создать вариант авторизации.
   4. Выберите Стандартный вариант авторизации и нажмите Создать и настроить. Подождите, пока ваш новый вариант авторизации не будет создан. Затем вы увидите страницу с настройками варианта авторизации.
   5. В блоке Способы авторизации выберите Авторизация через социальные сети и нажмите Настроить.
   6. Подключите социальные сети, которые используются для авторизации в вашем приложении.
   7. Нажмите название вашего варианта авторизации в цепочке навигации, чтобы вернуться на страницу варианта авторизации.
   8. Перейдите к блоку Безопасность и выберите раздел Подпись JWT.
   9. Выберите алгоритм генерации подписи RS256 и нажмите Сохранить изменения.

2. Реализуйте в клиентской части вашего приложения получение и обновление токена с помощью метода API Auth via access token of social network.

Получение токена с помощью custom ID

Реализуйте в серверной части вашего приложения получение и обновление токена с помощью метода API Auth by custom ID. Запрос должен содержать заголовок X-Server-Authorization: <server_JWT>, где <server_JWT> — серверный токен, полученный на предыдущем шаге.

Управление виртуальной валютой с помощью методов API