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

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

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

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

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

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

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

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

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

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

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

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

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

1. После наполнения корзины игроком используйте метод Fill cart with items для наполнения корзины. В ответе вернется текущая информация о выбранных товарах — цены до и после применения скидок, бонусные товары.
2. Используйте метод покупки корзины Create order with all items from current cart. В ответе вернутся ID заказа и платежный токен. Заказу будет присвоен статус New.
3. Откройте платежный интерфейс.

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

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

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

1. Измените корзину:
   • Для добавления товара или изменения его количества используйте метод Update cart item by card ID.
   • Для удаления товара используйте метод Delete cart item by card ID.

2. Используйте метод покупки корзины Create order with all items from current cart. В ответе вернутся ID заказа и платежный токен. Заказу будет присвоен статус New.
3. Откройте платежный интерфейс.

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

Чтобы оплатить товары, необходимо открыть платежный интерфейс с токеном, полученным в результате использования метода Create order with all items from current cart.

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

• В новом окне. Для открытия платежного интерфейса в браузере используйте ссылку: 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 минут. После этого (или если с веб-сокетом есть какие-либо проблемы), рекомендуется использовать простые запросы.

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

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