Биллинг и тарифные планы

Система биллинга 4phone отслеживает потребление ресурсов тенанта, управляет тарифными планами и формирует счета. Каждый тенант имеет свой баланс, тариф и расчетный период.

Обзор биллинга

На главной странице биллинга отображаются:

1. Баланс: текущее состояние счета. Отрицательный баланс означает задолженность.
2. Тарифный план: название текущего плана и статус аккаунта.
3. Расчетный период: даты начала и окончания текущего периода.

Расход по функциям

Система автоматически учитывает потребление по каждой категории:

1. Внутренние номера: количество активных добавочных номеров.
2. SIP-транки: количество активных транков.
3. Очереди: количество активных очередей.
4. DID-номера: количество подключенных входящих номеров.
5. Голосовые минуты: суммарное время разговоров.
6. Webhook-доставки: число отправленных вебхук-уведомлений.
7. Email-доставки: число отправленных email-уведомлений.
8. Минуты записи: объем сохраненных записей.
9. IVR-потоки: количество активных IVR-сценариев.
10. Хранилище: использованный объем в ГБ.
11. API-запросы: количество вызовов API.
12. Мониторинг: количество активных мониторов, проверок, звонков оповещения.

Для каждой метрики показывается:

1. текущее потребление;
2. включенный в тариф лимит (если есть);
3. процент использования.

Некоторые ресурсы тарифицируются по факту без фиксированного лимита.

Тарифные планы

Доступные тарифы отображаются в разделе Биллинг → Тарифы. Источник истины для тарифа — BillingPlan + BillingPriceItem + Subscription.

План может содержать:

1. цену активного внутреннего номера;
2. фиксированные ежемесячные ресурсы — базовую подписку, запись внутренних номеров, транки, DID, очереди, IVR, мониторинг и Telegram-отчеты;
3. usage-метрики — голосовой трафик, доставки, автоинформатор, проверки мониторинга, транскрибацию и другие счетчики;
4. includedQuantity для ресурса и цену каждой единицы сверх включенного объема.

Для внутреннего номера используется простая модель «цена за каждый активный номер»; включенное количество мест для extension_seat не применяется.

Смена тарифа

1. Откройте раздел Тарифы.
2. Выберите активный план.
3. Подтвердите переход.
4. Backend завершит предыдущую активную подписку, создаст новую и применит цену места нового плана к последующим начислениям.

Изменение тарифного плана фиксируется в журнале аудита.

Настройка тарифов администратором платформы

В Администрирование → Биллинг → Тарифы и услуги можно создавать планы, задавать стоимость каждой метрики и включенный объем. Изменение цены extension_seat автоматически применяется к биллинговым аккаунтам клиентов, подключенным к этому плану.

Счета

В разделе «Счета» отображается история начислений:

1. дата формирования;
2. расчетный период;
3. строки начисления и тарифицируемые метрики;
4. сумма;
5. срок оплаты;
6. статус: ISSUED, PAID, OVERDUE или VOID.

Счет считается оплаченным по ledger-проводкам, а не по визуальному остатку баланса. Поэтому точная оплата долга, например начисление 360 000 сум и последующее пополнение на 360 000 сум, закрывает счет при итоговом балансе 0.

Если платеж, которым был покрыт счет, возвращен платежной системой, refund создает обратную ledger-проводку. Если после возврата средств счет снова не покрыт, он возвращается в ISSUED или OVERDUE.

PREPAID и POSTPAID

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

В режиме POSTPAID само выставление счета не блокирует клиента. Блокировка применяется после наступления dueAt, когда счет получает статус OVERDUE, если задолженность не погашена и не действует отсрочка платежа.

Пополнение баланса

В кабинете доступен единый выбор способов оплаты:

• Payme;
• Click;
• Uzum Bank;
• Anorbank;
• Alif;
• Oson;
• Xazna;
• Beepul;
• Trastpay;
• SBP.

Пополнение доступно ролям OWNER, ADMIN и MANAGER. Минимальная сумма составляет 1 000 сум.

Как пополнить баланс

1. Откройте раздел «Оплата».
2. Укажите сумму в сумах или выберите готовое значение.
3. Выберите платежное приложение.
4. Нажмите «Перейти к оплате».
5. Завершите операцию на защищенной странице выбранной системы.

После возврата в кабинет операция сначала показывается как отправленная на обработку. Сам возврат из платежного приложения не означает, что деньги уже зачислены. Баланс обновится после подтверждения платежной системой, обычно это занимает до 1-2 минут.

История пополнений

В общей истории отображаются:

1. дата и сумма;
2. выбранный способ оплаты;
3. текущий статус;
4. внешний идентификатор операции;
5. ссылка на фискальный чек, если она получена.

Возможные статусы: «Ожидает», «В обработке», «Зачисление», «Оплачена», «Ошибка», «Возврат» и «Истек срок».

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

Возврат Multicard/Rahmat имеет отдельный статус REFUNDED/revert. Возврат не ограничивается изменением статуса внешней транзакции: backend создает обратную проводку и уменьшает внутренний баланс на возвращенную сумму. Повторные refund-callbacks обрабатываются идемпотентно, а поздний success-callback не может снова перевести уже возвращенную транзакцию в PAID.

Дополнительные функции

В разделе Биллинг → Доп. функции клиент видит каталог платных функций.

При подключении backend:

1. проверяет актуальный баланс внутри serializable-транзакции;
2. при недостатке средств отклоняет первичное подключение без частичной активации;
3. при успешном подключении создает ledger charge с идемпотентным ключом;
4. записывает пользователя, стоимость и событие в историю/audit;
5. для ежемесячной функции сохраняет дату следующего списания.

Продления выполняются singleton-задачей с distributed lock. Если на дату продления средств недостаточно, активная функция получает статус PENDING_FUNDS до следующей успешной попытки.

Использование

Раздел «Использование» показывает детальную разбивку потребления за текущий и прошлые периоды.

Перед закрытием расчетного периода backend принудительно пересобирает rollup закрываемого периода. Для usage-метрики денежное начисление рассчитывается как:

max(0, quantity - includedQuantity) × unitAmountMinor.

Результат попадает отдельными строками в invoice и затем одной идемпотентной charge-проводкой в ledger.

Следом полезно открыть Тарифы на сайте и Как устроена телефония 4phone.