Интеграция магазина в игру

После того как вы создали и настроили товары (виртуальные предметы, виртуальные валюты, бандлы, ключи) в Личном кабинете, добавьте магазин в вашу игру:

1. Реализуйте отображение каталога товаров.
2. Реализуйте логику продажи товаров.

Отображение каталога товаров

Реализуйте отображение каталога с помощью методов In-Game Store API:

Продажа товаров

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

1. Быстрая покупка одного товара. В этом случае вы можете продавать один артикул товара, но в любом количестве (например, 100 одинаковых зелий или виртуальную валюту).
2. Покупка корзины пользователя. В этом случае игрок предварительно наполняет корзину и может добавлять и убирать товары, изменять их количество в одном заказе.

Быстрая покупка

Покупка корзины

1. Наполнение корзины и получение токена:
   • На клиенте — если вы хотите самостоятельно реализовать корзину в своем приложении.
   • На сервере — если вы хотите использовать решение Xsolla (методы In-Game Store API) для управления корзиной.
2. Открытие платежного интерфейса.

Наполнение и покупка корзины на клиенте

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

1. После наполнения корзины игроком используйте метод Наполнение корзины товарами для наполнения корзины. В ответе вернется текущая информация о выбранных товарах — цены до и после применения скидок, бонусные товары.
2. Используйте метод покупки корзины Создание заказа с указанным товаром. В ответе вернутся ID заказа и платежный токен. Заказу будет присвоен статус New.
3. Откройте платежный интерфейс.

Наполнение и покупка корзины на сервере

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

Выполните следующие действия:

1. Измените корзину:
   • Для добавления товара или изменения его количества используйте метод Обновление товара в корзине по ID корзины.
   • Для удаления товара используйте метод Удаление товара из корзины по ID корзины.

2. Используйте метод покупки корзины Создание заказа со всеми товарами из текущей корзины. В ответе вернутся ID заказа и платежный токен. Заказу будет присвоен статус New.
3. Откройте платежный интерфейс.

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

Чтобы оплатить товары, необходимо открыть платежный интерфейс с токеном, полученным в результате использования метода Создание заказа с указанным товаром.

Реализуйте открытие платежного интерфейса одним из способов:

• В новом окне. Для открытия платежного интерфейса в браузере используйте ссылку: https://secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN, где ACCESS_TOKEN — полученный при создании заказа токен.
• В виджете. Используйте скрипт Xsolla PayStation Widget (файл README содержит инструкции по выполнению).

Тестирование платежей

Вы можете протестировать систему оплаты, используя тестовый режим (sandbox-режим). Тестирование вы можете выполнять с помощью тестовых карт и с любого аккаунта.

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

Существуют следующие способы получить статус заказа пользователя:

1. На стороне сервера с помощью вебхуков.
2. На стороне клиента с помощью WebSocket API или IGS API.

Получение статуса заказа на стороне сервера с помощью вебхуков

Получение статуса заказа на стороне клиента с помощью WebSocket API или IGS API

1. WebSocket API.
2. Простые запросы (Short-polling).

Получение статуса заказа на стороне клиента с помощью веб-сокет-соединения

Решение предусматривает использование веб-сокетов для получения статусов заказа без получения подробной информации о самом заказе. Этот способ является предпочтительным: между клиентом (например, вашим сайтом или мобильным приложением) и сервером Xsolla устанавливается только одно подключение, поэтому нет дополнительной нагрузки ни на клиент, ни на сервер.

Выполните следующие действия:

1. Для того чтобы веб-сокет-сервер Xsolla и ваш клиент могли идентифицировать сообщения со статусом заказа, создайте соединение:

const client = new Centrifuge(
connectionURL,
{
data: {
  user_external_id: user_external_id,
  auth: auth,
  project_id: project_id
}
}
)
connectionURL - wss://ws-store.xsolla.com/connection/websocket
auth - user JWT token

2. Чтобы получать новые сообщения о статусах заказов, подпишитесь на события с помощью функции client.on:

client.on('publication', (ctx) => {
   //handle the status
});

3. Установите соединение:

client.connect()

4. Чтобы получать историю изменений статусов заказов, подключите метод API history method.

client.on('subscribed', function (ctx) {
   client.history(ctx.channel, { limit: -1, since: { offset: 0 }, reverse: false }).then(function (resp) {
resp.publications.forEach((ctx) => {
   /handle the status
});

   }, function (err) {
       //handle the status
   });
});

Пример тела сообщения:

{
order_id: 59614241,
status: 'new'
}

Возможны следующие статусы заказа:

• New — заказ создан и еще не оплачен.
• Paid — заказ оплачен.
• Done — заказ полностью доставлен (в том числе отправлены все чеки, выполнены доставки на стороне Xsolla, внешних платформ и т.д.).
• Canceled — заказ отменен, оплата возвращена пользователю.

Рекомендации при работе с веб-сокетами:

• Установите максимальное время ожидания ответча через веб-сокет — 5 минут.
• Устанавливайте соединение при открытии платежного интерфейса.
• Прерывайте соединение после получения финального статуса заказа: Canceled или Done.
• По истечении времени жизни веб-сокета или при возникновении проблем с соединением используйте простые запросы.

  Простые запросы (short-polling)

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

  Примечание

  Используется периодический опрос статуса заказа — простой HTTP-запрос, который получает текущий статус заказа, а также информацию по нему. Рекомендуемая задержка между запросами — 3 секунды.
  Была ли статья полезна?

  Да

  Нет

  Спасибо!

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

  Жаль, что так произошло

  Расскажите, почему статья не была полезна. Сообщение Отправить

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

  Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
  Последнее обновление: 8 ноября 2024

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