Ограничения на покупку предметов

Как это работает

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

Настройка ограничений доступна в следующих сценариях:

  • продажа внутриигровых товаров – виртуальных предметов, пакетов виртуальной валюты, бандлов;
  • продажа игр и DLC через игровые ключи.

Вы можете настроить периодическое обновление ограничений:

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

Xsolla контролирует соблюдение ограничений и не позволяет пользователям приобрести количество товаров, которое превышает заданное ограничение:

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

Настройка и обновление ограничений

Настройка и обновление через Личный кабинет

Примечание
  • Настройка ограничений далее описана на примере виртуальных предметов.
  • Перед настройкой виртуальных предметов рекомендуется создать группы. Группы позволяют создавать многоуровневый каталог, а также управлять отображением предметов в магазине.
  • В Личном кабинете вы можете обновить ограничения для конкретного товара для всех пользователей. Расширенные возможности для настройки ограничений доступны через методы API.
Для создания предмета с ограниченным количеством использований:
  1. В проекте в Личном кабинете перейдите в раздел Каталог товаров > Все товары > Виртуальные предметы.
  2. Нажмите Добавить и выберите Виртуальные предметы.
  1. Укажите:
    • изображение;
    • артикул;
    • одну или несколько групп, которым должен принадлежать предмет;
    • название предмета;
    • описание предмета;
    • цену.
Примечание
При создании предмета необходимо указать его цену в реальной или виртуальной валюте. Предмет с нулевой ценой создать нельзя. При необходимости настройте региональные цены.
  1. Чтобы ограничить количество предметов, доступное для покупки, установите переключатель Ограничивать покупку предметов пользователем в положение Вкл и введите необходимое число.
  2. Чтобы настроить частоту обновления ограничений:
    1. В раскрывающемся списке выберите период:
      • Каждый день.
      • Каждую неделю.
      • Каждый месяц.
      • Настроить интервал. Интервал рассчитывается от даты начала периода показа предмета в магазине.
      • Без регулярного обновления.
    1. Задайте расписание обновления, указав параметры, соответствующие периоду.
  1. Чтобы настроить ограничение времени отображения предмета в магазине, выберите пункт Период времени и укажите часовой пояс, начало и конец периода. Чтобы не указывать конец периода отображения предмета, установите флажок Без даты окончания.
  2. Нажмите Создать предмет.

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

  1. В проекте в Личном кабинете перейдите в раздел Каталог товаров > Все товары > Виртуальные предметы.
  2. Перейдите в группу, которая содержит предмет.
  3. В строке необходимого предмета нажмите ••• и в раскрывающемся списке выберите Редактировать.
  4. В разделе Ограничения для одного пользователя задайте ограничение и/или в раскрывающемся списке выберите частоту обновления ограничений, затем выберите время и часовой пояс.
  5. Нажмите Сохранить изменения.
Примечание
Вы можете настроить ограничение на количество игровых ключей, доступных пользователю, на вкладке Каталог товаров > Все товары > Игровые ключи > Настройки цен. Чтобы настроить частоту обновления ограничений для игровых ключей, используйте методы API.

Настройка и обновление через методы API

Чтобы задать ежедневные, еженедельные или ежемесячные ограничения, передайте массив recurrent_schedule в методы API:

Для обновления ограничений и управления ими используйте методы API из раздела Ограничения:
ВозможностьМетод API
Обновить ограничения определенного товара для всех или конкретных пользователей.Обновление лимита на покупку.
Сбросить все ограничения на товары для конкретного пользователя.Обновление всех лимитов на покупку для пользователя.
Изменить ограничение на покупку определенного товара для конкретного пользователя.Настройка лимита доступных пользователю товаров.
Получить информацию, какие ограничения настроены для определенного товара для конкретного пользователя.Получение лимита доступных пользователю товаров.
Увеличить доступное количество покупок товара для конкретного пользователя.Увеличение лимита доступных пользователю товаров.
Уменьшить доступное количество покупок товара для конкретного пользователя.Уменьшение лимита доступных пользователю товаров.

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

Ограничения на продажу товаров отображаются в каталоге в зависимости от способа его реализации — через конструктор сайтов или с помощью API.

Отображение через конструктор сайтов

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

promo-limits-sb
Примечание
Чтобы привлечь внимание к акционным товарам, мы рекомендуем использовать Особый стиль карточки товара.

Получение информации об ограничениях через API

Если отображение каталога реализовано с помощью API, информация об ограничениях возвращается в массиве items.limits в методах получения каталога товаров:

Товары, на покупку которых пользователь исчерпал ограничения, возвращаются с флагом can_be_bought = false. Вы можете обновить эти ограничения. Эти данные можно использовать для отображения ограничений в каталоге, например чтобы указать максимальное количество доступных товаров.
Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Последнее обновление: 13 февраля 2026

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

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