IOSOR

IOSOR Wiedza

Korelacja webhooków statusu DLR z blokadami środków prepaid

Dowiedz się, jak uzgadniać przychodzące potwierdzenia doręczenia z zablokowanymi środkami prepaid, aby zwalniać zarezerwowane kwoty w infrastrukturze IOSOR CPaaS.

IOSOR tworzy tymczasową blokadę USD przy wysyłce SMS. Brak przetworzenia webhook DLR blokuje kapitał. Integracja z API JIT rozwiązuje środki.

Zrozumienie mechanizmu blokady środków prepaid

W ekosystemie IOSOR każde żądanie wysłania wiadomości SMS wyzwala natychmiastową kontrolę księgową JIT (Just-In-Time). W momencie inicjowania żądania system nakłada tymczasową blokadę na saldo konta, aby upewnić się, że dostępne są wystarczające środki na dostarczenie wiadomości. Blokada ta nie jest ostatecznym obciążeniem, lecz rezerwacją kapitału. Ostateczne rozliczenie następuje dopiero po otrzymaniu statusu DLR (Delivery Receipt) z sieci, co zapewnia, że księga finansowa dokładnie odzwierciedla rzeczywiste zużycie kredytów na wiadomości.

Cykl życia wywołania zwrotnego DLR

Po wysłaniu wiadomości sieć zwraca status DLR. Twój punkt końcowy webhooka odbiera ten ładunek, który zawiera unikalny identyfikator wiadomości i końcowy kod statusu. Silnik IOSOR koreluje ten identyfikator z oryginalnym rekordem transakcji. Jeśli status wskazuje na pomyślne doręczenie, system przekształca zablokowaną kwotę w stałe obciążenie. Jeśli status wskazuje na błąd, blokada jest zwalniana do dostępnego salda, co gwarantuje, że płacisz tylko za udane próby.

Zarządzanie uzgadnianiem księgi

Uzgadnianie jest zautomatyzowane, ale programiści muszą monitorować opóźnienie między wysyłką a nadejściem DLR. Jeśli DLR jest opóźniony, blokada pozostaje aktywna, co może tymczasowo obniżyć dostępny kredyt. W przypadku kont utrzymujących minimalny próg przedpłaty USD 20 jest to krytyczne, aby zapobiec przerwom w świadczeniu usług. Jeśli Twój miesięczny wolumen przekracza USD 1.000/miesiąc, nasz system uruchamia przegląd w celu dostosowania limitów kredytowych i zapewnienia płynnej przepustowości dla ruchu o wysokiej częstotliwości.

Obsługa przypadków brzegowych i limitów czasu

Nie wszystkie wiadomości otrzymują DLR w oczekiwanym oknie czasowym. Jeśli sieć nie dostarczy aktualizacji statusu, system IOSOR stosuje zadanie czyszczące, które zwalnia przestarzałe blokady po określonym czasie TTL (Time-To-Live). Zapobiega to wpływaniu 'widmowych' blokad na płynność finansową. Zawsze upewnij się, że Twój program obsługi webhooków potwierdza otrzymanie DLR w ciągu 500ms, aby utrzymać synchronizację między naszą księgą a Twoimi wewnętrznymi rekordami księgowymi.

Niezbędne zasoby integracyjne

Aby zapewnić solidność implementacji i zgodność z najlepszymi praktykami integralności finansowej, zapoznaj się z tymi przewodnikami:

Zacznij z IOSOR

Aby sfinalizować integrację, przejdź do konsoli IOSOR i przejdź do ustawień webhooków, aby skonfigurować punkt końcowy uzgadniania salda księgowego. Upewnij się, że Twój odbiornik jest gotowy do przetwarzania danych z ładunku dlr.status i mapowania ich bezpośrednio na odpowiedni identyfikator blokady transakcji. Przetestowanie tej korelacji w środowisku piaskownicy zagwarantuje, że zarezerwowane środki zostaną natychmiast zwolnione lub pobrane bez rozbieżności w księdze głównej.

Podsumowanie IOSOR

W tym przewodniku pokazano, jak bezpiecznie połączyć dostarczanie wiadomości w czasie rzeczywistym z dokładnością księgowości finansowej. Korelując przychodzące wywołania zwrotne DLR z aktywnymi blokadami przedpłat, zapobiegasz zamrożeniu kapitału i dbasz o to, aby dostępne saldo odzwierciedlało rzeczywisty stan dostarczenia, a nie najgorszy możliwy scenariusz.

Czy ten przewodnik był pomocny?

Powiązane przewodniki