Использование шаблона F2P

О решении

Используйте это решение и готовые инструменты Xsolla, чтобы монетизировать свою Free-to-play (F2P) игру с помощью собственного веб-магазина. В этом магазине доступна продажа виртуальных предметов, валюты и бандлов на внешнем сайте — независимо от того, распространяется ли ваша игра на ПК, консолях или является кроссплатформенной.

Основные возможности:

  • Гибкий и безопасный платежный интерфейс Xsolla, поддерживающий более 1000 способов оплаты по всему миру.
  • Интерфейс магазина, который легко настраивается через конструктор сайтов без необходимости разработки с нуля.
  • Полный контроль над каталогом товаров, ценообразованием и акциями.
  • Широкий выбор LiveOps-инструментов, например, скидочные акции, апселлы, система вознаграждений.

Это руководство описывает, как быстро создать и запустить веб-магазин для F2P-игры с использованием инструментов Xsolla.

Для кого подходит

Решение подойдет вам, если вы:

  • разрабатываете или издаете игры на ПК, консолях или кроссплатформенные игры;
  • хотите продавать внутриигровые товары и виртуальную валюту через собственный сайт;
  • ищете способ сэкономить на комиссии платформ;
  • хотите контролировать маркетинг, воронку продаж и данные пользователей.

Как настроить

  1. Создайте проект в Личном кабинете.
  2. Создайте каталог товаров.
  3. Создайте сайт.
  4. Настройте основные блоки.
  5. Настройте аутентификацию пользователей.
  6. Настройте вебхуки для начисления покупок пользователю.
  7. Протестируйте работу сайта.
  8. Опубликуйте сайт.

Создание каталога товаров

Чтобы создать каталог, вы можете:

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

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

  1. В проекте в Личном кабинете перейдите в раздел Каталог товаров > Виртуальные предметы.
  2. В раскрывающемся меню выберите Создать предмет.

  1. Задайте базовые настройки предмета в следующих полях:
    • Изображение (опционально).
    • Артикул (уникальный ID предмета).
    • Название предмета.
    • Описание (опционально).

  1. Задайте цену предмета:
    1. Установите переключатель Цены в реальной валюте в положение Вкл.
    2. В поле Цена в реальной валюте измените валюту (опционально) и укажите цену предмета.
    3. Если вы изменили валюту в поле Цена в реальной валюте, укажите эту же валюту в поле Валюта по умолчанию.

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

  1. Измените статус предмета на Доступен.

  1. Нажмите Создать предмет.

Создание сайта

  1. Откройте проект в Личном кабинете.
  2. На главной странице проекта нажмите Изменить фокус и выберите Продажа товаров в игре и онлайн.
  1. На шаге Опционально: Настройте веб-магазин нажмите Создать шаблон.
  1. На вкладке Экспресс добавьте ссылку на платформу, на которой доступна ваша игра — Steam или Epic Games Store. Это позволит быстро создать сайт, брендированный под вашу игру: при его создании в него автоматически добавляются изображение и название игры, сведения о разработчике, а также цветовая гамма.
  1. Нажмите Создать магазин.
  2. Нажмите Продолжить настройку.

Настройка основных блоков

Примечание
Ниже описана кастомизация основных блоков сайта, но вы можете добавить и настроить любые другие, доступные в конструкторе сайтов. Подробная информация о блоках приведена в документации Site Builder.
  1. На главной странице проекта в фокусе Продажа товаров в игре и онлайн на шаге Опционально: Настройте веб-магазин нажмите Кастомизировать сайт. Вы будете перенаправлены в конструктор сайта, в котором сможете кастомизировать созданный сайт.
Примечание

Если вы закрыли главную страницу проекта, перейдите в раздел Каналы продаж > Веб-сайты и нажмите Открыть Site Builder в панели созданного сайта. Чтобы найти созданный сайт в списке, вы можете ориентироваться на время создания, которое отображается в панели сайта.

  1. Настройте блок Хедер, в котором отображается информация о пользователе и содержатся элементы навигации по сайту:
    • Добавьте логотип вашей игры или студии.
    • При необходимости измените преднастроенные кнопки.

Пример блока Хедер:

  1. Настройте Заглавный блок, в котором отображается основная информация о вашем магазине:
    • Добавьте название, описание и фоновое изображение для блока, если вы хотите использовать название и изображение, отличные от автоматически загруженных.
    • Добавьте теги.
    • Укажите, на каких платформах доступна игра.
    • Измените преднастроенные кнопки или добавьте дополнительные при необходимости.
  1. Настройте блок Боевой пропуск, в котором отображается избранное предложение магазина:
    • Измените пользовательский фон карточки.
    • Добавьте название и описание предложения.
    • Настройке кнопку покупки: выберите товар для продажи и при необходимости измените стиль кнопки.
Примечание
Если вы не продаете боевой пропуск, вы можете удалить этот блок или кастомизировать его под другие акции, например специальные предложения. Это универсальный блок, в котором можно продавать товары любого типа или подписки.

Пример блока Боевой пропуск:

  1. Настройте блок Магазин, в котором отображаются виртуальные предметы, бандлы и пакеты виртуальных валют для продажи:
    • При необходимости удалите автоматически добавленные разделы или добавьте новые.
    • В блоке соответствующего раздела в раскрывающемся списке выберите тип и группу товаров для продажи, чтобы отобразить их на странице.
Внимание

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

Пример блока Магазин:

  1. Настройте блок Футер, в котором содержится правовая информация и настройки приватности. Вы можете:
    • Выбрать расположение элементов: столбцы или строки.
    • Добавить пользовательский фон.
    • Добавить ссылки на социальные сети.
    • Добавить возрастные ограничения.

Пример блока Футер:

  1. Перейдите в раздел Настройки корзины, чтобы настроить ее дополнительные возможности. Установите соответствующие переключатели в активное положение:
    • Показывать поле для промокода — позволяет пользователям использовать промокод или купон в интерфейсе корзины.
    • Авторизация пользователя до открытия корзины — открывает окно авторизации при переходе к корзине, если пользователь не был авторизован.
  2. При необходимости добавьте дополнительные страницы в свой магазин, например, с последними новостями вашей игры. Для этого:
    1. Добавьте необходимые страницы, следуя инструкциям.
    2. В блоке, в который вы хотите добавить переход на страницу, например, Хедер:
      1. Добавьте новую кнопку или перейдите к редактированию существующей.
      2. В разделе с настройками кнопки выберите действие при ее нажатии — Открыть страницу.
      3. В раскрывающемся списке выберите страницу, которая будет открываться при нажатии на кнопку.

Настройка аутентификации пользователя

Аутентификация позволяет пользователю покупать товары в магазине и видеть уникальные предложения в каталоге. Настройка аутентификации через Xsolla Login предоставляет пользователю широкий выбор способов авторизации: через социальные сети, с помощью одноразовых кодов или ссылок, с помощью ввода логина и пароля. Кроме этого вы сможете кастомизировать виджет Xsolla Login и вводить возрастные ограничения на авторизацию.

Чтобы настроить аутентификацию пользователей через Xsolla Login:

  1. В проекте в Личном кабинете перейдите в раздел Каналы продаж > Веб-сайты.
  2. Нажмите Открыть Site Builder в панели нужного сайта.
  3. В конструкторе вашего сайта перейдите в блок Настройки входа.
  4. Выберите вариант авторизации Xsolla Login.
  5. В раскрывающемся списке выберите Новый вариант Login. В результате автоматически будет создан вариант авторизации с возможностью аутентификации пользователя по email-адресу и паролю. Чтобы настроить другой вариант авторизации, следуйте инструкции.
Примечание

В настройках созданного варианта авторизации URL-адрес веб-магазина будет автоматически указан в качестве callback URL. Пользователь будет перенаправляться в веб-магазин в следующих случаях:

  • после успешной аутентификации;
  • после подтверждения электронной почты;
  • после сброса пароля;
  • в случае ошибки аутентификации.

При смене домена веб-магазина callback URL в настройках варианта авторизации изменяется автоматически.

  1. Подключите хранилище для данных пользователя. В зависимости от способа хранения данных пользователей вам доступна разная функциональность продукта (см. раздел Сравнение хранилищ для данных пользователей).
Примечание

Вы можете настроить и другие способы аутентификации пользователя:

  • через ID пользователя;
  • через ID пользователя и диплинк;
  • через диплинк;
  • с привязкой ID пользователя.

Подробная информация о настройке каждого способа приведена в инструкции.

Начисление покупки пользователю

Реализуйте в вашем приложении начисление покупок пользователю, используя полученную в вебхуках информацию от Xsolla о деталях транзакции и купленных товарах. Если вы зарегистрировались в Личном кабинете после 22 января 2025 г., для полноценной работы магазина и управления платежами, реализуйте обработку следующих вебхуков:

Название вебхукаОписание
Проверка пользователей > Проверка существования пользователя (user_validation)Отправляется на разных этапах оплаты, чтобы удостовериться, что пользователь зарегистрирован в игре.
Игровые сервисы > Объединенные вебхуки > Успешная оплата заказа (order_paid)Данные платежа, детали транзакции и информация о купленных товарах. Используйте данные вебхука для начисления товаров пользователю.
Игровые сервисы > Объединенные вебхуки > Отмена заказа (order_canceled)Данные отмененного платежа, детали транзакции и информацию о купленных товарах. Используйте данные вебхука для списания купленных товаров у пользователя.
Примечание
Подробная информация о настройке вебхуков, а также список вебхуков, которые необходимо использовать, если вы зарегистрировались в Личном кабинете до 22 января 2025 г., приведены в инструкции.

Тестирование сайта в тестовом окружении

Чтобы протестировать работу сайта в тестовом окружении:

  1. В проекте в Личном кабинете перейдите в раздел Каналы продаж > Веб-сайты.
  2. Нажмите Открыть Site Builder в панели нужного сайта.
  3. Нажмите Просмотр.
  1. Выберите товар и нажмите кнопку покупки.
  2. Выберите группу способов оплаты Карта.
  3. Введите реквизиты тестовой банковской карты. Остальные поля могут быть заполнены любыми данными. Вы также можете указать неверные реквизиты (номер карты, срок действия или CVV) для генерации ошибки.
Примечание
Оплатить покупку в тестовом окружении возможно только тестовой банковской картой. Платежи могут проводиться в следующих валютах: USD, EUR, RUB, GBP, AED, ALL, AMD, ARS, AUD, AZN, BGN, BRL, BYN, CAD, CHF, CLP, CNY, COP, CZK, DKK, DZD, EGP, GEL, HKD, HRK, HUF, IDR, ILS, INR, ISK, JPY, KES, KGS, KRW, KZT, MAD, MDL, MKD, MNT, MXN, MYR, NGN, PEN, PHP, PKR, PLN, RON, RSD, SAR, SEK, SGD, THB, TRY, TWD, UAH, UYU, UZS, VEF, VND, ZAR.

Публикация сайта

  1. Чтобы повысить эффективность сайта:
    1. В разделе Настройки SEO задайте параметры, которые будут учитываться поисковыми системами и использоваться для отображения предпросмотра страницы в социальных сетях: загрузите фавикон, укажите заголовок и описание магазина, добавьте изображение для предпросмотра.
    2. Настройте локализацию сайта.
    3. Внесите изменения в домен (опционально). Для этого перейдите в Каналы продаж > Веб-сайты и нажмите Настроить в панели вашего сайта. В разделе Домен внесите изменения в Домен Xsolla или подключите собственный домен.
  1. После того как вы внесли все необходимые изменения и ваш веб-магазин готов к запуску, нажмите Опубликовать.
Внимание
Если публикация сайта недоступна, убедитесь, что соблюдаются условия:

Расширенная настройка магазина

Вы можете использовать дополнительные возможности для вашего магазина:

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

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

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