Недействительный MSISDN не должен списывать средства

Недействительный MSISDN не должен списывать средства.

Валидация на входе против ошибок доставки

При маршрутизации больших объемов трафика SMS или OTP крайне важно отличать недействительный адрес назначения на входе от сбоя доставки на стороне сети. Некорректный MSISDN должен отклоняться мгновенно на уровне API-шлюза до совершения каких-либо транзакций по балансу. Если неверный номер обходит входные проверки, он может вызвать DLR со статусом 'unknown', что выглядит как расход, но не приводит к доставке. IOSOR применяет строгие правила валидации для предотвращения таких ситуаций.

Парсинг формата E.164 на платформе

Каждый запрос API к мобильному номеру проходит парсинг в реальном времени на соответствие международному стандарту E.164. Платформа проверяет код страны, национальный код направления и длину номера абонента. Если формат неверен, шлюз возвращает ошибку HTTP 400 Bad Request. Эта JIT-валидация гарантирует, что несуществующие маршруты блокируются до выделения ресурсов или применения удержания средств. Это предотвращает отправку запросов во внешние сети.

Правила баланса и удержание средств

Для поддержания корректного баланса IOSOR использует систему учета в реальном времени. Когда принимается валидный запрос SMS, на вашем балансе создается временное удержание (prepaid hold). Если сообщение успешно отправлено, удержание превращается в списание. Однако, если номер признан недействительным на входе, удержание не создается, и списания не происходит. Это защищает ваш лимит USD 20 prepaid floor от растраты на некорректные строки. Для растущих аккаунтов мягкий аудит (soft review) около USD 1,000/month помогает оптимизировать таблицы маршрутизации и лимиты MRC.

Структура вебхуков и коды ошибок

Когда сообщение отклоняется на входе, ответ API содержит подробную структуру ошибки. Вместо ожидания асинхронного вебхука DLR ваше приложение получает мгновенный синхронный ответ. Этот ответ содержит невалидный параметр и код отклонения. Для корректных номеров система выполнит JIT-назначение маршрута и отправит обновления статуса через webhook, включая события STOP и Verify OK, обеспечивая полную прозрачность без лишней траты ресурсов.

Ресурсы для разработчиков и интеграция

Чтобы построить надежную интеграцию и избежать лишних трат, разработчикам следует внедрить валидацию на стороне клиента перед отправкой запросов к API. Изучите эти руководства для оптимизации вашей системы:

• Проверка формата телефонов E.164 на входе API
• Первая неделя пилота: правда о холдах и списаниях на живом трафике
• чеклист покупки SMS API

Начните с IOSOR

Из песочницы отправьте POST на номер без кода страны и на номер невозможной длины. Ждите HTTP 400 и нетронутый ledger — ни hold, ни debit. Затем отправьте валидный E.164 и убедитесь, что hold появляется только после accept. Если деньги сдвинулись на неверной паре, разбор на входе сломан.

Итог IOSOR

Отказ формата на входе — не сбой доставки. Невалидный MSISDN никогда не должен открывать hold. Делайте: разбирайте E.164 до движения денег. Не делайте: ждать unknown DLR, чтобы объяснить списание, которого не должно быть. Ledger молчит, пока номер не собран правильно.