IOSOR База знаний

Сообщение в очереди: холдирование баланса вместо списания

Узнайте, как IOSOR обрабатывает очереди сообщений в биллинге. Находящееся в очереди SMS резервирует средства на балансе и списывает их только после подтверждения отправки.

Сообщение в очереди: холдирование баланса вместо списания.

Почему статус очереди требует резервирования средств

Когда клиент отправляет запрос на отправку SMS или трафика OTP через API, система помещает каждое сообщение в статус очереди перед передачей в сеть. Списание средств сразу при получении API-запроса приводит к искажению финансовой отчетности. Если на маршруте возникают задержки или номер E.164 оказывается недействительным, предварительное списание создает ошибки в биллинге. Платформа IOSOR предотвращает такие риски, применяя временный холдирующий режим для всех сообщений в очереди.

Механика биллинга: различие между холдом и окончательным списанием

При обработке запроса биллинговый модуль проверяет доступный баланс и создает временный холд на сумму, соответствующую тарифу назначения. Этот холд блокирует необходимые средства для гарантирования отправки, но не производит окончательного списания. Как только система получает статус отправки или DLR через webhook, холд конвертируется в финальное списание. Если отправка отменяется, резерв снимается автоматически.

Таймауты, отмена отправки и возврат заблокированных сумм

Сетевые задержки или сбои на стороне маршрутизации могут удерживать SMS в очереди дольше обычного. Если для сообщения истекает время жизни TTL или фиксируется отказ, шлюз отменяет операцию. Модуль учета холдов мгновенно выполняет возврат заблокированных средств на доступный баланс. Это исключает необходимость ручных корректировок и обращения в службу поддержки.

Лимиты платформы и пороги проверки аккаунта

Для поддержания непрерывности операций аккаунт должен сохранять минимальный депозит USD 20 prepaid floor. Это обеспечивает необходимый лимит для создания холдов при массовых рассылках. При росте объема отправки и приближении ежемесячных расходов к отметке USD 1,000/month система проводит soft review. Эта процедура оптимизирует параметры JIT-выделения номеров и проверяет устойчивость финансового модуля без остановки сервиса.

Мониторинг статусов очереди и аудит транзакций

Разработчики и администраторы могут отслеживать изменения статусов сообщений в реальном времени через журналы API и webhook-уведомления. Каждое событие содержит точные идентификаторы транзакций для сверки холдов и списаний. Дополнительные материалы по теме биллинга и управления очередями:

Начните с IOSOR

Перейдите в консоль IOSOR и откройте раздел Billing & Webhooks, чтобы проверить настройки отображения статусов списания. Настройте обработку событий вебхуков message.queued и message.sent, четко разграничив предварительную блокировку средств (hold) и окончательное списание. Убедитесь, что логика вашего приложения не фиксирует статус пребывания в очереди как протарифицированную отправку.

Итог IOSOR

Нахождение сообщения в очереди представляет собой временное резервирование емкости и баланса, а не окончательное списание средств. Мы доказали, что использование авторизационных удержаний предотвращает искажение финансового учета при задержках шлюза, сбоях маршрутизации или истечении времени жизни пакета.

Четко разделяйте состояния queued и sent на уровне вашей учетной системы и гарантируйте автоматический возврат холдов при таймаутах очереди. Не списывайте юниты с основного баланса до момента фактической передачи сообщения в сеть и фиксации статуса отправки.

Был ли материал полезен?

Связанные гайды