Бесплатные товары

Бесплатные товары — это вид товаров, которые пользователь может получить, не тратя виртуальную или реальную валюту. К ним относятся:

• виртуальные предметы;
• бандлы;
• пакеты виртуальной валюты.

Бесплатные товары доступны для получения только авторизованным пользователям. Неавторизованные пользователи могут только просматривать каталог бесплатных товаров.

Примеры использования:

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

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

Чтобы настроить бесплатные товары:

1. Добавьте бесплатные товары в каталог.
2. Реализуйте логику приобретения пользователем бесплатного товара.
3. Реализуйте логику начисления бесплатных товаров пользователю.

Добавление бесплатных товаров в каталог

Подробные инструкции по созданию товаров приведены в разделах:

• Создание пакета виртуальной валюты;
• Создание виртуальных предметов;
• Создание бандлов.

Для бесплатных товаров требуется при создании или редактировании товара в разделе Платно или бесплатно выбрать Бесплатный предмет, Бесплатный пакет или Бесплатный бандл.

Приобретение бесплатного товара пользователем

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

• В один клик (не используя корзину) — подходит для приобретения одного артикула товара, но в любом количестве. Например, 100 одинаковых зелий.
• Через корзину — подходит для приобретения любого типа товара в любом количестве.

Приобретение бесплатного товара в один клик

Для реализации этого способа вызовите метод SDK PurchaseFreeItem при нажатии в каталоге на кнопку приобретения товара.

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

Приобретение бесплатного товара через корзину

Если пользователь использует покупку через корзину:

• Если в корзине пользователя находятся и платные, и бесплатные товары, используйте метод SDK Purchase класса Cart. Этот метод инкапсулирует в себе методы создания заказа, открытия платежного интерфейса и отслеживания статуса заказа.

• Если в корзине пользователя находятся только бесплатные товары, используйте метод SDK PurchaseFreeCart класса Cart. Начисление товара в инвентарь на стороне Xsolla происходит сразу после успешного вызова этого метода, без необходимости открывать платежный интерфейс.

Начисление бесплатных товаров пользователю

Методы Purchase, PurchaseFreeItem и PurchaseFreeCart содержат логику отслеживания статуса заказа. При их вызове передайте в параметре onSuccess функцию, которая вызывается в случае перехода заказа в статус done. Обновите инвентарь в клиентской части приложения одним из способов:

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

Полезные ссылки