IOSOR

IOSOR База знаний

Синхронизация DLR-вебхуков с удержанием средств

Узнайте, как сопоставлять отчеты о доставке с заблокированными средствами на балансе для корректного списания в платформе IOSOR.

Отправка OTP SMS через IOSOR вызывает временную блокировку баланса в USD. Если входящий DLR webhook обработан некорректно, капитал останется замороженным. Настройка сверки через API с использованием JIT обеспечивает моментальное списание или возврат средств.

Механика блокировки средств на балансе

В архитектуре IOSOR каждый исходящий SMS-запрос инициирует мгновенную проверку JIT-баланса. В момент отправки система резервирует сумму, эквивалентную стоимости сообщения, чтобы гарантировать наличие средств. Это не окончательное списание, а временная блокировка. Финальный расчет происходит только после получения DLR, что обеспечивает точность финансового учета в реальном времени.

Жизненный цикл обратного вызова DLR

После отправки сообщения сеть возвращает статус доставки. Ваш вебхук получает полезную нагрузку, содержащую уникальный ID сообщения. Система IOSOR сопоставляет этот ID с записью о транзакции. Если статус подтверждает доставку, заблокированная сумма переходит в разряд списанных. Если зафиксирован сбой, резерв снимается, возвращая средства на доступный баланс, что исключает переплату за недоставленные сообщения.

Управление сверкой финансового реестра

Автоматизированная сверка требует контроля задержек между отправкой и получением DLR. При задержке ответа резерв остается активным, временно снижая доступный лимит. Для аккаунтов с порогом USD 20 это критично для предотвращения пауз в работе. При достижении оборота свыше USD 1,000/month система проводит мягкий аудит для оптимизации лимитов и обеспечения стабильной пропускной способности.

Обработка исключений и таймаутов

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

Рекомендуемые технические материалы

Для обеспечения финансовой прозрачности и надежности интеграции изучите следующие руководства:

Начните с IOSOR

Чтобы завершить интеграцию, перейдите в консоль IOSOR и откройте настройки вебхуков для настройки конечной точки сверки баланса. Убедитесь, что ваш обработчик готов принимать полезную нагрузку dlr.status и сопоставлять её с идентификатором удержания транзакции. Тестирование этой корреляции в песочнице гарантирует мгновенное списание или разблокировку зарезервированных средств без расхождений в реестре.

Итог IOSOR

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

Обязательно проектируйте обработчик вебхуков как строго идемпотентный, чтобы исключить повторные корректировки баланса при дублировании DLR. Не полагайтесь исключительно на мгновенные колбэки — всегда настраивайте резервный механизм TTL для автоматического снятия зависших удержаний, если сеть не возвращает статус доставки.

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

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