Планы и аддоны
Типы плана (type)
В API и сущности плана используются числовые типы:
| Значение | Название | Назначение |
|---|---|---|
1 | Основной план | Базовая подписка с интервалом (intervalUnit × intervalCount) |
2 | Рекуррентный аддон | Доплата каждый биллинговый период вместе с основным планом |
3 | Разовый аддон | Однократная покупка (часто при оформлении или отдельной оплате) |
Связь «какие аддоны можно купить с этим тарифом» задаётся полями основного плана: списки идентификаторов рекуррентных и разовых аддонов (bindingAddonIds, bindingOnetimeAddonIds).
Периодичность
intervalUnit:day|week|month|yearintervalCount: натуральное число (например, каждые 3 месяца:month+3)
Конец периода вычисляется от якоря биллинга (billingCycleAnchor) и настроек плана.
Разовые платежи и подписка
Платёж в системе может относиться к разным бизнес-типам (BizType):
| Значение | Смысл |
|---|---|
Разовый (BizTypeOneTime) | Разовая покупка без привязки к циклу подписки |
Счёт (BizTypeInvoice) | Оплата выставленного счёта |
Подписка (BizTypeSubscription) | Оплата в контексте подписки |
| Пополнение кредита | Пополнение промо/кредитного баланса |
На практике разовую продажу часто оформляют через счёт + платёж или через разовый аддон к продукту с подпиской (см. рецепты).
Пробный период и отмена
- У плана могут быть поля trial (сумма/длительность): первый период может быть бесплатным или со спец.ценой.
cancelAtTrialEnd— поведение при окончании триала (передаётся в логику подписки).
Автосписание
disableAutoCharge на плане:
- если включено (значение ≠ 0), автоматическое списание за цикл для этого плана не выполняется;
- счета можно выставлять и оплачивать вручную через админку или API.
Это основной рычаг для сценария «фиксированная цена, но постоплата / счёт по факту» в терминах продукта (см. Подписка с постоплатой (ручной биллинг)).
Метрики на плане
Помимо фиксированной цены плана, на план вешаются:
- лимиты (
metricLimits) — ограничение потребления по метрике; - metered charge — тарификация накопленного usage за период;
- recurring charge по метрике — отдельная модель начисления в цикле.
Подробнее — Биллинг и счета и Метрики в рецептах.
Для ограничений, которые не должны логироваться в billing usage (например, срок хранения документов), используйте Policy-квоты: дефолты на продукте + переопределения на плане.