Быстрый старт

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

Чтобы интегрировать решение Payments:

1. Создайте проект в Личном кабинете. Один проект соответствует одной игре. Если у вас несколько игр, создайте проект для каждой из них.
2. Добавьте ваши товары для продажи в каталог на стороне Xsolla.
3. Протестируйте создание заказа, который будет оплачивать пользователь.
4. Протестируйте совершение тестовой покупки и настройте оповещения.
5. Подпишите лицензионный договор с Xsolla в Личном кабинете, чтобы начать принимать реальные платежи.

Создание каталога

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

Создание виртуальных предметов

• Настройка через Личный кабинет
• Настройка через методы API

1. Откройте ваш проект в Личном кабинете.
2. В боковом меню перейдите в раздел Магазин.
3. В панели Виртуальные предметы нажмите:
   • Подключить — если вы не подключали виртуальные предметы раньше.
   • Настроить — если вы уже подключали виртуальные предметы.
4. Нажмите Создать предмет.

5. Заполните информацию о предмете. Обязательные поля:
   • Артикул — уникальный ID предмета;
   • Название предмета;
   • Краткое описание предмета;
   • Цена в реальной валюте.
6. Установите переключатель Показать предмет в магазине в положение Вкл.
7. Нажмите Создать предмет.

Для дальнейшей работы вам потребуется артикул созданного предмета:

Для настройки виртуальных предметов используйте методы подраздела Admin из группы методов Virtual Items & Currency.

Примечание

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

Получение списка предметов

Для получения списка предметов, вызовите метод API Get virtual items list. В запросе передайте параметр project_id — ID проекта, который вы можете найти в Личном кабинете:

В ответе вы получите детальную информацию о виртуальных предметах, созданных в вашем проекте. Для последующего создания заказа вам понадобится артикул товара, который передается в параметре items.sku.

Создание заказа

Заказ — это товары, которые пользователь выбрал для покупки в магазине. После того как заказ оплачен, пользователь получает товары. Чтобы совершить платеж, пользователь должен быть авторизован в игре.

Выберите способ интеграции, подходящий для вашей игры, чтобы посмотреть инструкцию для настройки.

• На стороне сервера
• На стороне клиента

Вызовите метод API Create payment token for purchase и передайте в нем информацию о пользователе и о товаре. Используя этот метод API, вы сможете продавать как один, так и несколько товаров.

Чтобы использовать тестовое окружение (sandbox-режим), передайте параметр "sandbox": true в теле запроса на получение токена.

Пример запроса:

Copy

Full screen

Small screen

curl -i -X POST \
  -u 224575:MYAPIKEY \
  https://sandbox-secure.xsolla.com/api/v2/project/224575/admin/payment/token \
  -H 'Content-Type: application/json' \
  -d '{
    "user": {
      "id": {
        "value": "myUserID"
      }
    },
    "purchase": {
      "sandbox": true,
      "items": [
        {
          "sku": "mySKU",
          "quantity": 1
        }
      ]
    }
  }'

Интегрируйте продукт Авторизация Иксолла:

1. Создайте проект.
2. Настройте вариант авторизации в Личном кабинете.
3. Подключите хранилище для пользовательских данных.
4. Интегрируйте решение на стороне вашего приложения.

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

Для тестирования оплаты создайте заказ, используя метод API Create order with specified item:

1. Если вы тестируете на сайте документации API, нажмите Try it для открытия интерфейса создания запроса.
2. В блоке Security в поле Bearer Token введите токен, полученный при прохождении аутентификации.
3. В блоке Body передайте информацию о заказе, например количество товара. Чтобы получить доступ к тестовому окружению, передайте "sandbox": true.
4. В блоке Parameters введите:
   • project_id — ID проекта, который вы можете найти в Личном кабинете.
   • item_sku — артикул товара.

В ответе вы получите данные, которые вам понадобятся для дальнейшей работы:

• token — платежный токен.

Пример запроса:

Copy

Full screen

Small screen

curl -i -X POST \
  'https://store.xsolla.com/api/v2/project/{project_id}/payment/item/{item_sku}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "sandbox": true,
    "quantity": 5,
    "settings": {
      "ui": {
        "theme": "63295a9a2e47fab76f7708e1",
      }
    },
    "custom_parameters": {
      "character_id": "ingameUsername"
    }
  }'

Примечание

Для работы с Xsolla API вы можете использовать готовые методы SDK для игровых движков и платформ:

• Unity
• Unreal Engine
• Cocos Creator
• Android

Совершение тестовой покупки

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

Чтобы открыть платежный интерфейс в новом окне, используйте URL-адрес https://sandbox-secure.xsolla.com/paystation4/?token=TOKEN, где TOKEN — это токен, полученный при создании заказа.

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

Совершение тестового платежа

1. Откройте платежный интерфейс в тестовом окружении.
2. Выберите способ оплаты Карта банка.
3. Введите реквизиты карты. Остальные поля (например, имя или адрес) могут быть заполнены любыми данными. Вы также можете указать неверные реквизиты (номер карты или срок действия) для генерации ошибки.
4. Нажмите Оплатить.

Список тестовых карт

Посмотрите список тестовых банковских карт.

Настройка вебхуков

Если вы настраиваете интеграцию на стороне сервера, вам необходимо валидировать создаваемые заказы, отправляя соответствующие коды в ответ на вебхуки. Если вы настраиваете интеграцию на стороне клиента, вебхуки позволят вам получать уведомления о настроенных событиях (например, о статусе оплаты заказа).

PHP SDK

Используйте готовые классы для обработки вебхуков.

Чтобы настроить вебхуки на стороне Xsolla:

1. Откройте ваш проект в Личном кабинете.
2. Нажмите Настройки проекта в боковом меню и перейдите в раздел Вебхуки.
3. Установите переключатель Вебхуки в положение Вкл.
4. Укажите URL-адрес, на который вы хотите получать вебхуки.
5. Секретный ключ проекта для подписи вебхуков генерируется по умолчанию. Если вы хотите изменить его, нажмите значок обновления.
6. Нажмите Сохранить настройки.

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

• Проверка существования пользователя — для оповещения о подтверждении регистрации пользователя в игре.
• Успешный платеж — для оповещения о совершении платежа.

Настройка обработчика вебхуков

Обработчик вебхуков — это программный код, который позволяет принимать поступающие вебхуки на указанный URL-адрес, генерировать подпись и отправлять ответ на вебхук на сервер Xsolla.

Запуск

Подписание лицензионного договора

Подписание лицензионного договора позволит вам принимать реальные платежи, используя любые способы оплаты, поддерживаемые Xsolla. Чтобы подписать лицензионный договор:

1. Зайдите в свой аккаунт в Личном кабинете.
2. В боковом меню перейдите в раздел Договоры и налоги > Договоры.
3. На вкладке Лицензионный договор нажмите Заполнить форму договора.
4. Заполните поля в соответствии с вашими данными.

Ваша заявка будет рассмотрена в течение 3 рабочих дней. Если в процессе проверки возникнут вопросы, Xsolla свяжется с указанным в заявке контактным лицом. После прохождения проверки на стороне Xsolla статус вашего договора изменится на Подписан.

Переключение на боевое окружение

После выполнения предыдущих шагов вы можете начать принимать реальные платежи:

1. Убедитесь, что вы подписали договор с Xsolla.
2. Уберите параметр "sandbox": true из тела запроса при получении токена.
3. Откройте платежный интерфейс по ссылке https://secure.xsolla.com/paystation4/?token=TOKEN.

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

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

В другой раз

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