Интеграция магазина в игру
После того как вы создали и настроили товары (виртуальные предметы, виртуальные валюты, бандлы, ключи) в Личном кабинете, добавьте магазин в вашу игру:
- Реализуйте отображение каталога товаров.
- Реализуйте логику продажи товаров.
Отображение каталога товаров
Реализуйте отображение каталога с помощью методов In-Game Store & Buy Button API:
Задача | Метод |
---|---|
Отобразить полный список виртуальных предметов, добавленных в ваш магазин | Get virtual items list |
Отобразить на клиенте список групп виртуальных предметов, доступных для продажи | Get item groups list |
Отобразить на клиенте список виртуальных валют, доступных для продажи в вашем магазине | Get virtual currency list |
Отобразить полный список пакетов виртуальных валют, добавленных в ваш магазин | Get virtual currency package list |
Отобразить полный список бандлов виртуальных валют, добавленных в ваш магазин | Get list of bundles |
Продажа товаров
Вы можете продавать товары следующими способами:
- Быстрая покупка одного товара. В этом случае вы можете продавать один артикул товара, но в любом количестве. Например, 100 одинаковых зелий.
- Покупка корзины пользователя. В этом случае игрок предварительно наполняет корзину и может добавлять и убирать товары, изменять их количество в одном заказе.
Быстрая покупка
- Используйте метод Create order with specified item. В ответе вы получите токен.
- Откройте платежный интерфейс, используя полученный токен.
Покупка корзины
Реализуйте логику:
- Наполнение корзины и получение токена:
- На клиенте — если вы хотите самостоятельно реализовать корзину в своем приложении.
- На сервере — если вы хотите использовать решение Иксоллы (методы In-Game Store & Buy Button API) для управления корзиной.
- Открытие платежного интерфейса.
Наполнение и покупка корзины на клиенте
Самостоятельно реализуйте логику добавления и удаления товаров в корзину. Также необходимо учитывать, что до вызова метода наполнения корзины у вас не будет информации о том, какие акции будут применены при покупке. Это означает, что итоговая стоимость и сведения о добавленных бонусных предметах будут неизвестны.
- После наполнения корзины игроком используйте метод Fill cart with items для наполнения корзины. В ответе вернется текущая информация о выбранных товарах — цены до и после применения скидок, бонусные товары.
- Используйте метод покупки корзины Create order with all items from current cart. В ответе вернутся идентификатор заказа и платежный токен. Заказу будет присвоен статус New.
- Откройте платежный интерфейс.
Наполнение и покупка корзины на сервере
Этот вариант наполнения корзины может занимать значительное время на настройку, поскольку каждое изменение корзины может сопровождаться вызовом большего количества методов API.
Выполните следующие действия:
- Измените корзину:
- Для добавления товара или изменения его количества используйте метод Update cart item by card ID.
- Для удаления товара используйте метод Delete cart item by card ID.
- Используйте метод покупки корзины Create order with all items from current cart. В ответе вернутся идентификатор заказа и платежный токен. Заказу будет присвоен статус New.
- Откройте платежный интерфейс.
Открытие платежного интерфейса
Чтобы оплатить товары, необходимо открыть платежный интерфейс с токеном, полученном в результате использования метода Create order with all items from current cart.
Реализуйте открытие платежного интерфейса одним из способов:
- В новом окне. Для открытия платежного интерфейса в браузере используйте ссылку:
https://secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN
, гдеACCESS_TOKEN
— полученный при создании заказа токен. - В виджете. Используйте скрипт Xsolla PayStation Widget (файл README содержит инструкции по выполнению).
Тестирование платежей
Вы можете протестировать систему оплаты, используя тестовый режим (sandbox-режим). Тестирование вы можете выполнять с помощью тестовых карт и с любого аккаунта.
Для включения или отключения тестового режима вам необходимо изменить значение параметра sandbox
в теле запроса методов быстрой покупки и покупки корзины. По умолчанию тестовый режим выключен.
Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.