Ограничение количества использований акций

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

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

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

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

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

Примечание

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.