SDK для Unreal Engine / Бесплатные товары
  На главную

SDK для Unreal Engine

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Примечание
Вы также можете воспользоваться методами SDK для реализации логики покупки одного товара.

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

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

  • Если в корзине пользователя находятся и платные, и бесплатные товары:
    1. Получите платежный токен и ID заказа с помощью метода SDK FetchCartPaymentToken.
    2. Реализуйте ​​открытие платежного интерфейса. Для этого вызовите метод SDK LaunchPaymentConsole, передайте в него платежный токен и ID заказа.

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

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

Вы можете отслеживать статус приобретения бесплатного товара с помощью вызова по таймеру метода SDK CheckPendingOrder.

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

Примечание
Если вы настроили на сервере вашего приложения обработку вебхуков Xsolla, вы можете обновлять данные в клиентской части приложения при получении вебхука order_paid.
Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Оценить страницу
Оценить страницу
Что может сделать страницу еще лучше?

В другой раз

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

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

Последнее обновление: 22 января 2024

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

Сообщите о проблеме
Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
Укажите email-адрес, чтобы мы могли связаться с вами
Спасибо за обратную связь!