# Основная информация

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

Лимиты хранятся на стороне Xsolla и задаются в настройках каждой акции в [Личном кабинете](https://publisher.xsolla.com/0/projects/0/storefront/promotions) или через объект `limits` в следующих методах API:
* [Создание акции со скидками для товара](/ru/api/liveops/promotions-discounts/create-item-promotion/) или [Обновление акции со скидками](/ru/api/liveops/promotions-discounts/update-item-promotion)
* [Создание акции с бонусами](/ru/api/liveops/promotions-bonuses/create-bonus-promotion/) или [Обновление акции с бонусами](/ru/api/liveops/promotions-bonuses/update-bonus-promotion)

Информация о лимитах возвращается в объекте `items.promotions.limits` в методах API получения каталога товаров:
* [Получение списка виртуальных предметов](/ru/api/catalog/virtual-items-currency-catalog/get-virtual-items/)
* [Получение списка виртуальных валют](/ru/api/catalog/virtual-items-currency-catalog/get-virtual-currency/)
* [Получение списка пакетов виртуальной валюты](/ru/api/catalog/virtual-items-currency-catalog/get-virtual-currency-package/)
* [Получение списка бандлов](/ru/api/catalog/bundles-catalog/get-bundle-list/)
* [Получение списка игр](/ru/api/catalog/game-keys-catalog/get-games-list/)

Методы подраздела **Управление** из группы методов **Лимиты** позволяют получать информацию о текущем состоянии лимитов и изменять их для конкретного пользователя — например, сбрасывать счетчик после выполнения квеста или корректировать остаток вручную.

<div class="note">
  <b>Примечание</b><br><br>
  Подробная информация по настройке лимитов в каталоге приведена в разделе <a href="/ru/liveops/promotion-tools/liveops-number-limits/">Лимиты на количество использований акций</a>.
</div>

Вы можете настроить [limits.per_user](/ru/api/liveops/promotions-discounts/create-item-promotion#promotions-discounts/create-item-promotion/t=request&path=limits) —  лимит на количество использований акции для одного пользователя.

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

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

Чтобы настроить период автоматического обновления — ежедневно, еженедельно или ежемесячно, передайте объект `limits.recurrent_schedule` при [создании](/ru/api/liveops/promotions-discounts/create-item-promotion#promotions-discounts/create-item-promotion/t=request&path=limits/recurrent_schedule) или [обновлении](/ru/api/liveops/promotions-discounts/update-item-promotion#promotions-discounts/update-item-promotion/t=request&path=limits/recurrent_schedule) акции.

**Сценарий настройки и применения лимитов**

1. Вы создаете акцию через методы API [Создание акции со скидками для товара](/ru/api/liveops/promotions-discounts/create-item-promotion/) или [Создание акции с бонусами](/ru/api/liveops/promotions-bonuses/create-bonus-promotion/) и передаете объект `limits`.
2. Вы запрашиваете каталог для неавторизованного пользователя — в ответе возвращается максимальное количество использований акции в объекте `items.promotions.limits`.
3. Пользователь авторизуется.
4. Вы запрашиваете каталог, передавая авторизационный токен пользователя — в ответе возвращается оставшееся количество использований с учетом действующего лимита.
5. Пользователь выбирает акционный товар и совершает покупку.
6. После успешного платежа Xsolla уменьшает значение параметра `items.promotions.limits.per_user`. Когда значение этого параметра достигает `0`, товар возвращается в методах запроса каталога — без скидки или бонуса.
7. Вы можете обновить лимит через методы подраздела **Управление**:
   * [сбросить все лимиты акций для пользователя](/ru/api/liveops/user-limits-admin/reset-all-user-promotions-limit/) или [лимиты конкретной акци](/ru/api/liveops/user-limits-admin/reset-user-promotion-limit/);
   * [задать конкретное значение лимита](/ru/api/liveops/user-limits-admin/set-user-promotion-limit/);
   * [увеличить](/ru/api/liveops/user-limits-admin/add-user-promotion-limit/) или [уменьшить доступное количество использований](/ru/api/liveops/user-limits-admin/remove-user-promotion-limit/).
8. Вы получаете обновленное значение лимита в `items.promotions.limits` при следующем запросе каталога с авторизационным токеном пользователя и отображаете его пользователю.

![Лимиты на использование акций](https://cdn.xsolla.net/developers/current/images/api_docs/promotion-limit.svg)