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

Система биллинга 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. процент использования.

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

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

Доступные тарифы отображаются в разделе «Планы». Каждый тариф включает:

1. базовую стоимость в месяц;
2. набор включенных ресурсов с лимитами;
3. стоимость превышения по каждой категории.

Смена тарифа

1. Откройте раздел «Планы».
2. Выберите новый тариф.
3. Подтвердите переход.

Счета

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

1. дата формирования;
2. расчетный период;
3. сумма;
4. статус оплаты.

Пополнение баланса через Multicard

Multicard - это универсальный платежный шлюз, поддерживающий карты UzCard, Humo, Visa, Mastercard, UnionPay, а также быструю оплату через Payme, Click, Uzum и другие приложения. Пополнение доступно ролям OWNER, ADMIN и MANAGER.

Как пополнить баланс через Multicard

1. Откройте раздел «Биллинг».
2. В блоке «Пополнить баланс через Multicard» введите сумму в сумах (минимум 1 000).
3. Нажмите «Перейти к оплате» -- вас перенаправит на защищенную страницу Multicard.
4. Введите данные карты, подтвердите оплату по SMS-коду (OTP).
5. После подтверждения вы вернетесь на страницу биллинга, баланс обновится в течение 1-2 минут.

В блоке «История платежей через Multicard» отображаются последние транзакции с их статусом (Ожидает оплаты, В обработке, Оплачена, Ошибка, Возврат, Истек срок), а также ссылка на фискальный чек, если он есть.

Технические детали Multicard

Интеграция работает через Multicard Shop API. При создании инвойса наш сервер получает JWT-токен (POST /auth), вызывает POST /payment/invoice с store_id, amount (в тийинах), invoice_id (наш UUID транзакции) и callback_url. Multicard возвращает checkout_url, на который перенаправляется браузер пользователя.

После успешного списания Multicard отправляет на наш сервер два callback:

1. success-callback (с IP 195.158.26.90) -- проверяется MD5-подпись md5(store_id + invoice_id + amount + secret). Если ответить {success: true}, средства зачисляются. Если {success: false} -- Multicard откатывает транзакцию.
2. webhook-callback на каждое изменение статуса (draft / progress / billing / success / error / revert / hold) -- проверяется SHA1-подпись sha1(uuid + invoice_id + amount + secret). Используется для синхронизации статуса транзакции в базе.

Безопасность callback:

1. IP-whitelist (MULTICARD_ALLOWED_IPS=195.158.26.90) -- запросы с других IP блокируются.
2. Проверка подписи timing-safe сравнением.
3. Проверка совпадения суммы с сохраненной в MulticardTransaction.
4. Идемпотентность: повторный success-callback по уже PAID-транзакции возвращает {success: true} без создания дубликата Payment.

Все транзакции хранятся в таблице multicard_transactions с привязкой к BillingAccount и Tenant. После успешной оплаты создается Payment со статусом PAID и методом MULTICARD -- эта сумма участвует в расчете баланса.

Пополнение баланса через Click

Тенанты могут пополнять расчетный счет онлайн через платежную систему Click (карты UzCard и Humo). Пополнение доступно ролям OWNER, ADMIN и MANAGER.

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

1. Откройте раздел «Биллинг».
2. В блоке «Пополнить баланс через Click» введите сумму в сумах (минимум 1 000).
3. Нажмите «Перейти к оплате» -- вас перенаправит на защищенную страницу Click.
4. Введите данные карты и подтвердите оплату по SMS.
5. После подтверждения вы вернетесь на страницу биллинга, баланс обновится в течение 1-2 минут.

В блоке «История платежей через Click» доступны последние транзакции с их статусом (Ожидает оплаты, Подтверждена, Оплачена, Отменена).

Технические детали

Интеграция работает по протоколу Click Shop API: ваш платеж проходит этапы Prepare и Complete, на каждом из которых Click обращается к нашему серверу с MD5-подписью. Ключи интеграции хранятся в защищенном виде на стороне сервера и не передаются в браузер.

Все транзакции сохраняются в базе данных с уникальным идентификатором Click и привязываются к биллинговому аккаунту тенанта. После успешного Complete формируется запись Payment со статусом PAID и методом CLICK -- эта сумма участвует в расчете баланса наравне с ручными платежами и кредитами.

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

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

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