Лимиты на покупку товаров

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

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

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

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

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

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

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

• каталога товаров с использованием методов подраздела Catalog из группы методов Виртуальные предметы и валюта;
• каталога игр с использованием методов подраздела Catalog из группы методов Игровые ключи.

Для настройки ограничений на использование акций обратитесь к инструкции.

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

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

Для создания предмета с ограниченным количеством использований:

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

3. Укажите:
   • изображение;
   • артикул;
   • одну или несколько групп, которым должен принадлежать предмет;
   • название предмета;
   • описание предмета;
   • цену.

4. Чтобы ограничить количество предметов, доступное для покупки, активируйте переключатель Ограничивать покупку предметов пользователем и введите необходимое число.
5. Чтобы настроить частоту обновления лимитов:
   1. В раскрывающемся списке выберите период:
      • Каждый день.
      • Каждую неделю.
      • Каждый месяц.
      • Настроить интервал. Интервал рассчитывается от даты начала периода показа предмета в магазине.
      • Без регулярного обновления.

1. 2. Задайте расписание обновления, указав параметры, соответствующие периоду.

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

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

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

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

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

5. Нажмите Сохранить изменения.

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

Чтобы настроить лимиты для товаров через API, используйте объект limits в следующих методах:

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

Чтобы задать ежедневные, еженедельные или ежемесячные обновления лимитов, передайте объект limits.recurrent_schedule.

Если у вас настроен период обновления лимитов, вы также можете настроить отображение товара в каталоге после достижения лимита покупок. Для этого передайте параметр “limits.per_user.limit_exceeded_visibility”: “show”.

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

Для обновления лимитов и управления ими через API используйте следующие методы подраздела Управление из группы методов Лимиты:

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

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

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

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

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

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

• Получение списка виртуальных предметов
• Получение списка виртуальных валют
• Получение списка пакетов виртуальной валюты
• Получение списка бандлов
• Получение списка игр

Товары, на покупку которых пользователь исчерпал лимиты, возвращаются с флагом can_be_bought = false. Вы можете обновить эти лимиты. Эти данные можно использовать для отображения лимитов в каталоге, например чтобы указать максимальное количество доступных товаров.

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

Последнее обновление: 13 февраля 2026