Korelacija DLR statusnih webhookova s predplaćenim rezervacijama

Sva SMS poruka u sustavu IOSOR stvara privremenu rezervaciju sredstava u USD na vašem računu. Ako ne povežete ispravno dolazne DLR webhookove s tim rezervacijama, rizikujete blokiranje kapitala. Implementirajte JIT usklađivanje putem API sučelja za točno knjiženje.

Razumijevanje mehanizma predplaćene rezervacije

U IOSOR ekosustavu svaki odlazni SMS zahtjev pokreće trenutnu JIT (Just-In-Time) provjeru glavne knjige. Kada se zahtjev pokrene, sustav postavlja privremenu rezervaciju na stanje računa kako bi osigurao dovoljna sredstva za isporuku poruke. Ova rezervacija nije konačno terećenje, već rezervacija kapitala. Konačno namirenje događa se tek po primitku DLR (Delivery Receipt) statusa iz mreže, čime se osigurava da vaša financijska evidencija točno odražava stvarnu potrošnju kredita za poruke.

Životni ciklus DLR povratnog poziva

Nakon što je poruka poslana, mreža vraća DLR status. Vaša webhook krajnja točka prima ovaj payload, koji sadrži jedinstveni ID poruke i konačni statusni kod. IOSOR motor korelira ovaj ID s izvornim zapisom transakcije. Ako status ukazuje na uspješnu isporuku, sustav pretvara rezervirani iznos u trajno terećenje. Ako status ukazuje na neuspjeh, rezervacija se oslobađa natrag na vaše raspoloživo stanje, osiguravajući da plaćate samo za uspješne pokušaje.

Upravljanje usklađivanjem glavne knjige

Usklađivanje je automatizirano, ali programeri moraju pratiti latenciju između slanja i dolaska DLR-a. Ako DLR kasni, rezervacija ostaje aktivna, što može privremeno smanjiti vaš raspoloživi kredit. Za račune koji održavaju minimalni predplaćeni prag od USD 20, ovo je kritično za izbjegavanje prekida usluge. Ako vaš mjesečni volumen premašuje USD 1.000/mjesečno, naš sustav pokreće pregled za prilagodbu vaših kreditnih limita i osiguravanje nesmetane propusnosti za visokofrekventni promet.

Rješavanje rubnih slučajeva i vremenskih ograničenja

Ne primaju sve poruke DLR unutar očekivanog vremenskog okvira. Ako mreža ne pruži ažuriranje statusa, IOSOR sustav koristi zadatak čišćenja koji oslobađa zastarjele rezervacije nakon definiranog TTL-a (Time-To-Live). To sprječava da 'duhovne' rezervacije utječu na vašu likvidnost. Uvijek osigurajte da vaš webhook rukovatelj potvrdi primitak DLR-a unutar 500ms kako biste održali sinkronizaciju između naše glavne knjige i vaših internih računovodstvenih zapisa.

Osnovni resursi za integraciju

Kako biste osigurali da je vaša implementacija robusna i slijedi najbolje prakse za financijski integritet, pogledajte ove vodiče:

• Redoslijed događaja u odnosu na knjiženje u glavnoj knjizi
• Duplikat webhook poruke ne smije stvoriti drugo terećenje
• idempotentnost, ponavljanja i novac

Započnite s IOSOR-om

Kako biste dovršili integraciju, idite na IOSOR konzolu i otvorite Webhook Settings kako biste konfigurirali krajnju točku za usklađivanje glavne knjige. Provjerite je li vaš slušatelj spreman obraditi dlr.status paket podataka i mapirati ga izravno na odgovarajući ID rezervacije transakcije. Testiranje ove korelacije u sandbox okruženju jamči da će rezervirana sredstva biti oslobođena ili terećena trenutno, bez odstupanja u glavnoj knjizi.

Sažetak IOSOR

Ovaj vodič je pokazao kako sigurno premostiti jaz između isporuke poruka u stvarnom vremenu i točnosti financijske glavne knjige. Povezivanjem dolaznih DLR povratnih poziva s aktivnim prepaid rezervacijama sprječavate blokiranje kapitala i osiguravate da raspoloživo stanje odražava stvarna stanja isporuke, a ne najgori mogući scenarij.