Обзор и сущности
Ниже — сущности, с которыми работает мерчант в админ-панели, и типичные связи между ними.
Сущности и разделы админки
| Сущность | Путь в админ-панели | Назначение |
|---|---|---|
| Подписка | /subscription/* | Договор на план с периодами, статусом и оплатами |
| План / продукт | /plan/* (список с productId в URL) | Каталог: продукт группирует планы |
| Клиент (пользователь) | /user/* | Покупатель: счета, подписки, метрики |
| Счёт | /invoice/* | Начисление: строки, налоги, связь с подпиской или разовой оплатой |
| Платёж (транзакция) | /transaction/* | Попытка списания через шлюз, статусы, возвраты |
| Метрика | /billable-metric/* | Определение usage/лимита и ценообразования |
| События метрик | /metric-events/* | Журнал переданных в BillBill событий |
| Настройки | /configuration/*, /merchant | Шлюзы, вебхуки, профиль, ключи API |
Упрощённая модель данных
Ключевые процессы
- Оформление подписки — выбор основного плана (и опционально аддонов), превью счёта, оплата, активация периода.
- Цикл биллинга — по наступлению нового периода формируется счёт (база плана + аддоны + начисления по метрикам), при успешной оплате период продлевается.
- Usage — внешняя система шлёт события метрик; при закрытии периода накопленное потребление попадает в счёт (см. Биллинг и счета).
«Фишки» платформы
- Несколько платёжных шлюзов и валют (на уровне настроек мерчанта).
- Скидочные коды и промо-кредиты как уменьшение суммы счёта.
- Шаблоны документов (HTML + EJS) для визуального счёта и PDF.
- Исходящие вебхуки на сторону мерчанта при смене статусов подписки, счёта, платежа и др. (список событий).
- Отключение автосписания на уровне плана (
disableAutoCharge) для сценариев ручного выставления счетов.
Дальше: Планы и аддоны.