# ADR-0032. Тарифы в платформе

- Статус: принято; этап 10 — 10.1
- Дата: 2026-11-17

## Контекст

Цены опубликованы на rebonus.ru 17 ноября 2026 года. Есть три тарифа:

- «Старт» — 3 900 ₽ в месяц;
- «Бизнес» — 7 900 ₽;
- «Сеть» — 14 900 ₽.

Тарифы различаются лимитами: точки продаж, кассы и участники программы. Возможности во всех тарифах одинаковые. За 6
месяцев вперёд — скидка 10 %, за 12 — 20 %, цена месяца округлена вниз до сотен рублей. Пилоту и сети больше «Сети»
нужны свои условия. Оплата по счёту ИП; эквайринга и счетов из системы пока нет (10.3).

Платформе не хватало трёх вещей:

- мерчант не видел своего тарифа и того, сколько он уже использует;
- оператор не видел, кому пора выставить счёт и кто вышел за лимиты;
- оплаты нигде не записывались.

## Решение

### Тариф — данные платформы о мерчанте

Тариф и оплаты принадлежат платформе: ими распоряжается она, а не мерчант. Поэтому их таблицы называют мерчанта по
`merchant_id` и не являются данными тенанта — как доступ поддержки (ADR-0015). Консоль видит тарифы всех мерчантов
одним запросом, без системного логина. Таблицы доступны только роли сотрудников (ADR-0029): публичному трафику тариф
не нужен.

- `merchant_subscriptions` — условия мерчанта на сегодня:
  - тариф и период оплаты (1, 6 или 12 месяцев);
  - цена периода и лимиты — копия каталога на момент назначения или условия по договорённости;
  - последний оплаченный день;
  - последний подсчёт использования;
  - когда тариф закончился вместе с закрытием мерчанта.
- `merchant_payments` — оплаты, которые записала платформа. Оплата не меняется, её можно только отменить, один раз.
  Строки этих таблиц не удаляются, и база это охраняет.

Персональных данных в таблицах нет.

### Каталог в коде

Каталог тарифов — это `Plan`: цены периодов и лимиты, как на сайте. Тест сверяет карточки тарифов на сайте с каталогом:
разойтись им не даст. Мерчант сохраняет условия, назначенные ему: изменение каталога дойдёт до него только при
следующем назначении.

«Индивидуальный» тариф — цена периода и лимиты, о которых договорились. Пустой лимит означает «без ограничений». Цена 0
— бесплатный период, например пилот: его последний день — конец пилота, а без него период бессрочный.

### Оплаченные дни

День считается по календарю платформы (`billing.timezone`, Москва). Оплата продлевает оплаченные дни до конца своего
периода.

- Период начинается на следующий день после оплаченных дней — даже если оплата пришла с опозданием: счёт продолжает
  оплаченное.
- Если оплаченных дней нет, период начинается в день оплаты.
- Оператор может указать начало периода сам.
- Период в N месяцев кончается накануне того же числа через N месяцев. Если такого числа в месяце нет, период
  кончается последним днём месяца: с 31 января на месяц — по 28 февраля.
- От опечаток в годе: дни не раньше 1 января 2026 года, оплата не позже сегодняшнего дня, оплаченные дни — не дальше
  пяти лет вперёд, а начало периода, которое оператор ввёл сам, — не дальше 400 дней вперёд.

Отмена оплаты не трогает оплаченные дни. Их поправляет «Изменить срок оплаты» — с причиной, как и отмена. Оплата
отменяется один раз: вторая отмена, даже одновременная, получает отказ.

### Закрытый мерчант

Тариф заканчивается вместе с закрытием мерчанта, в той же транзакции. Его дни и оплаты остаются, но из списков
действующих тарифов и «Пора выставить счёт» он уходит. Закрытому мерчанту тариф не назначают. Когда мерчанта снова
открывают, ему назначают тариф заново.

### Лимиты показываются, но не останавливают работу

Использование считается так:

- точки продаж — работающие точки;
- кассы — работающие кассы всех видов: касса (и касса МоегоСклада), веб-касса, интернет-магазин (сайт на Tilda),
  мобильное приложение, интеграция;
- участники — участники всех программ, кроме обезличенных и объединённых.

Мерчант видит использование на странице «Тариф» в момент открытия. Платформа считает его каждый день
(`billing:count-usage`) для открытых мерчантов с действующим тарифом, каждого в его тенанте, и по этому подсчёту список
«Тарифы» показывает тех, кто вышел за лимиты.

Превышение лимита работу не останавливает. Касса, которая перестала бы начислять баллы из-за тарифа, подвела бы
покупателей мерчанта, а не его самого. Оператор видит превышение и предлагает тариф больше. Без оплаты тоже ничего не
останавливается: работа с должниками и приостановка — это 10.3.

### Кто что видит

- Мерчант: страница «Тариф» — условия, оплачен ли тариф и до какого дня, использование против лимитов, оплаты и куда
  писать (`billing.contact_email`). Видят владельцы и администраторы мерчанта (право `billing.view`), владельцы и
  администраторы его партнёра (они работают у мерчанта как администраторы) и доступ поддержки, который только читает.
- Консоль: «Тарифы» — действующие тарифы, первыми те, кому пора выставить счёт.
  - Фильтры:
    - «Вышли за лимиты»;
    - «Пора выставить счёт» — платный тариф без оплат, а также любой тариф, у которого оплаченные или бесплатные дни
      кончаются в 14 дней или кончились;
    - «Закончились» — тарифы закрытых мерчантов.
  - Страница тарифа мерчанта открывается из «Тарифов» и «Мерчантов».
  - Изменения делают администраторы (`merchants.manage`): назначить тариф, отметить оплату, отменить её, изменить
    срок оплаты.
  - Каждое изменение пишется в журнал платформы и копией без ввода — в журнал мерчанта.

## Последствия

- Цена меняется в двух местах — в каталоге и на сайте, — и тест держит их вместе. Мерчантам с назначенным тарифом
  новая цена приходит только с новым назначением.
- Пока что оператор записывает оплаты вручную, по выписке. Счета, акты, эквайринг и приостановка должников — это 10.3.
- Хранится только последний подсчёт использования. Ежемесячный учёт — максимум за месяц, чеки и сообщения — это 10.2:
  он сохранит подсчёты по дням.
- Тарифы партнёров и их оптовые цены — 10.4. Сейчас тариф назначается мерчанту, какой бы партнёр его ни привёл, и
  сотрудники партнёра видят тариф мерчанта как его администраторы.
