IOSOR

IOSOR База знань

Кореляція DLR-вебхуків із резервуванням коштів

Дізнайтеся, як узгоджувати звіти про доставку із заблокованими коштами на балансі для точного списання в інфраструктурі IOSOR.

Під час відправки OTP SMS через IOSOR система застосовує тимчасове резервування коштів у USD. Якщо ваш сервер некоректно зіставляє вхідні DLR вебхуки з цими блокуваннями, ви ризикуєте отримати розбіжності у фінансовому балансі. Використання JIT-сценарію через наш API дозволяє автоматично коригувати баланс, знімаючи або повертаючи резерв залежно від статусів доставки.

Принцип роботи резервування коштів

В екосистемі IOSOR кожен запит на відправку SMS активує миттєву перевірку JIT-балансу. Під час ініціації запиту система блокує суму, необхідну для доставки, гарантуючи наявність коштів. Це не фінальне списання, а тимчасове резервування. Остаточний розрахунок виконується лише після отримання DLR, що забезпечує точність фінансового обліку та відповідність фактичному споживанню кредитів.

Життєвий цикл зворотного виклику DLR

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

Управління звіркою фінансового реєстру

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

Обробка винятків та таймаутів

Не всі повідомлення отримують DLR в очікуваний час. Якщо мережа не надає статус, IOSOR запускає фонове завдання для очищення застарілих резервів після закінчення TTL. Це запобігає виникненню 'фантомних' утримань. Завжди налаштовуйте свій обробник вебхуків на підтвердження отримання DLR протягом 500 мс для підтримки синхронізації між нашим реєстром та вашою бухгалтерією.

Необхідні ресурси для інтеграції

Для забезпечення надійності вашої інтеграції та фінансової цілісності зверніться до цих посібників:

Почніть з IOSOR

Щоб завершити інтеграцію, перейдіть до консолі IOSOR та відкрийте налаштування вебхуків для конфігурації кінцевої точки звірки балансу. Переконайтеся, що ваш обробник готовий приймати дані dlr.status і зіставляти їх із відповідним ідентифікатором утримання транзакції. Тестування цієї кореляції в пісочниці гарантує миттєве списання або розблокування зарезервованих коштів без розбіжностей у реєстрі.

Підсумок IOSOR

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

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

Чи був матеріал корисним?

Пов’язані гіди