Серверная интеграция

Этот тип интеграции подходит для партнеров, которые уже разработали игровую логику для авторизации, внутриигрового магазина и инвентаря игроков на своих серверах и хотят использовать платежный интерфейс Иксоллы. Необходимо получить Pay Station access token и настроить обработку оповещений.

При серверной интеграции реализуется следующая логика обработки платежа:

1. Клиент отправляет на сервер приложения запрос для открытия платежного интерфейса.
2. Сервер приложения отправляет на сервер Иксоллы сведения о валюте и размере платежа.
3. Сервер Иксоллы возвращает токен со сведениями о покупке и параметрах платежного интерфейса.
4. Сервер приложения отправляет полученный токен на клиент.
5. Клиент открывает платежный интерфейс в браузере с помощью SDK.
6. После оплаты покупки на сервер приложения приходит оповещение со статусом платежа.

Сервер Discord

Общайтесь с командой Иксоллы и разработчиками, использующими продукты Иксоллы.

Сценарий интеграции

Для интеграции продуктов Иксоллы с вашими серверами с помощью плагина Game Commerce:

1. Установите плагин.
2. Настройте проект в Личном кабинете.
3. Настройте внутриигровой магазин и каталог товаров на вашем сервере.
4. Настройте проект UE4.
5. Получите токен.
6. Откройте платежный интерфейс.
7. Настройте оповещения.

После завершения интеграции вы можете протестировать процесс оплаты.

Установка плагина

1. Скачайте Epic Games Launcher.
2. Создайте новый проект UE4.
3. Загрузите плагин из Unreal Engine Marketplace или GitHub.

После установки плагина вы можете запустить демокарты из директории Content Browser > Xsolla Content > Maps. Демокарты показывают возможности плагина и представляют собой возможный вариант реализации логики приложения.

Для демокарт в Личном кабинете предварительно настроен проект и сконфигурирован внутриигровой магазин.

Значения по умолчанию для демокарт:

Вы можете использовать демокарты двумя способами:

• в качестве примера;
• в качестве начальной версии вашей системы авторизации, инвентаря, внутриигрового магазина и т. д., чтобы получить быстрый результат и при необходимости расширить его возможности.

Настройка проекта в Личном кабинете

1. Зарегистрируйтесь в Личном кабинете.
2. Настройте проект, созданный автоматически после регистрации в Личном кабинете:
   1. В разделе Проекты выберите ваш проект и перейдите в Настройки проекта.
   2. На вкладке Общие настройки добавьте:
      • изображение (опционально);
      • языки проекта (английский установлен по умолчанию);
      • название проекта на всех добавленных языках;
      • сайт игры (опционально);
      • описание проекта (опционально).
   3. Нажмите Сохранить.

В процессе интеграции вам понадобятся следующие параметры:

• ID продавца, который можно найти в разделе Настройки проекта > Оповещения.

• Ключ API, который можно найти в разделе Настройки компании > Ключ API.

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

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

Настройка проекта UE4

1. Откройте проект в Unreal Editor.
2. Только для Blueprint-проектов:
   1. Скомпилируйте UE4-проект.
   2. Перейдите в Content Browser и добавьте New C++ Class с родительской нодой None.

3. Перейдите в Settings > Plugins > Installed > Xsolla Store SDK, установите флажок Enabled и нажмите кнопку Restart Now, чтобы сохранить настройки и перезапустить Unreal Editor.

4. Перейдите в Content Browser > View Options и установите флажки Show Engine Content и Show Plugin Content.

5. Разработайте интерфейс для системы входа, внутриигрового магазина и других пользовательских страниц вашего приложения. Вы можете создать собственное решение, следуя инструкциям UMG для UI.
6. Настройте обработку событий в соответствии с логикой вашего приложения с помощью методов SDK.

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

Для получения токена используйте метод API Create payment token by server. Ваш сервер должен отправлять на сервер Иксоллы запрос со следующими данными:

• идентификатор пользователя, совершившего покупку;
• сумма платежа;
• валюта платежа;
• сведения о покупке (опционально);
• параметры платежного интерфейса (опционально).

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

• в виде списка предметов через параметр item;
• в виде описания покупки через параметр description.

Параметры платежного интерфейса (например, язык локализации, свойства интерфейса, тема) передаются в объекте settings. Для включения/отключения sandbox-режима требуется изменить значение параметра sandbox в запросе на получение токена и изменить настройки SDK. Для изменения остальных настроек платежного интерфейса требуется изменить параметры запроса на получение токена.

Открытие платежного интерфейса

Чтобы открыть платежный интерфейс, передайте полученный на предыдущем шаге токен в метод SDK LaunchPaymentConsoleWithAccessToken.

Настройка оповещений

1. Перейдите к вашему проекту в Личном кабинете.
2. Перейдите в Настройки проекта > Оповещения, укажите URL оповещения и сгенерируйте секретный ключ проекта для подписи оповещений.

3. Сохраните настройки.
4. Реализуйте обработку следующих типов оповещений:
   • Проверка существования пользователя
   • Успешный платеж
   • Отмена платежа

5. Перейдите на вкладку Чекаут и нажмите Подключить.

6. Протестируйте оповещения.

7. Нажмите Платежи в боковом меню и перейдите в раздел Настройки.
8. Установите переключатель Чекаут в положение Вкл.

9. Нажмите Сохранить.

Тестирование процесса оплаты

После успешной настройки плагина вы можете проверить процесс оплаты. По умолчанию все платежи проводятся в sandbox-режиме. Вы можете использовать тестовую банковскую карту для имитации успешного процесса оплаты.

Для тестирования оплаты на реальных платежах:

1. Убедитесь, что вы заключили договор с Иксоллой.
2. В вашем проекте UE4 снимите флажок Sandbox в разделе Settings > Project Settings > Plugins > Xsolla Payments.
3. В запросе на получение токена для параметра sandbox укажите значение false.

Оценить страницу

Что может сделать страницу еще лучше? Отправить

В другой раз

Спасибо за обратную связь!