Лимит на количество использований акций

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

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

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

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

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

Примечание

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

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

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

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

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

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

  1. В проекте в Личном кабинете перейдите в раздел LiveOps-инструменты > Акции.
  2. Нажмите Создать акцию.
  3. Укажите название акции.
  4. В раскрывающемся списке выберите тип Скидка или Бонус.
  5. В зависимости от выбранного типа акции заполните остальные поля.
  6. Нажмите Далее.
  7. Для ограничения количества использований акции на странице Условия и ограничения установите переключатель Ограничивать использование акции пользователем в положение Вкл и введите необходимое число использований.
  1. Для настройки персонализированной акции установите переключатель Акция для определенных пользователей в положение Вкл. Чтобы настроить персонализацию, воспользуйтесь инструкцией.
  2. Нажмите Далее.
  3. Укажите период действия акции: часовой пояс, начало и конец периода. Чтобы не указывать конец периода действия акции, установите флажок Без даты окончания.
  4. Нажмите Далее.
  5. Проверьте настройки и нажмите Сохранить и выйти.
  6. Чтобы активировать акцию:
    1. В каталоге акций найдите только что созданную акцию.
    2. В строке с необходимой акцией нажмите ••• и в раскрывающемся списке выберите Редактировать.
    3. В правом верхнем углу в раскрывающемся меню выберите Активировать акцию.
Чтобы настроить ограничение на уже созданную акцию или обновить ограничения:
  1. В проекте в Личном кабинете перейдите в раздел LiveOps-инструменты > Акции.
  2. В строке необходимой акции нажмите ••• и в раскрывающемся списке выберите Редактировать.
  3. Если нужная вам акция активна, деактивируйте ее в правом верхнем углу в раскрывающемся списке.
  4. В разделе Условия и ограничения задайте ограничение или нажмите Обновить лимит сейчас, чтобы обновить заданное ограничение на использование акции.
  5. Проверьте настройки и нажмите Сохранить изменения.
  6. Чтобы активировать акцию, в правом верхнем углу в раскрывающемся меню выберите Активировать акцию.

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

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

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

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

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

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

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

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

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

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

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

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

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

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