Недійсний 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 мовчить, доки номер не зібраний правильно.