IOSOR

IOSOR Znalosti

Korelace DLR stavových webhooků s předplacenými blokacemi

Naučte se, jak sladit příchozí potvrzení o doručení s drženými předplacenými prostředky pro uvolnění rezervovaných částek v infrastruktuře IOSOR CPaaS.

Při odesílání SMS zpráv v systému IOSOR dochází k okamžité blokaci kreditu v USD. Častou chybou je nesprávné párování webhooků pro stav DLR, což vede k zablokování prostředků i u nedoručených zpráv. Správné nastavení JIT synchronizace přes API zajistí přesné uvolnění či zaúčtování každé transakce.

Pochopení mechanismu předplacené blokace

V ekosystému IOSOR každý odchozí požadavek na SMS spustí okamžitou kontrolu účetní knihy typu JIT (Just-In-Time). Při zahájení požadavku systém umístí na zůstatek účtu dočasnou blokaci, aby zajistil dostatek prostředků pro doručení zprávy. Tato blokace není konečným debetem, ale rezervací kapitálu. Konečné zúčtování proběhne až po obdržení stavu DLR (Delivery Receipt) ze sítě, což zajišťuje, že váš finanční přehled přesně odráží skutečnou spotřebu kreditů na zprávy.

Životní cyklus DLR zpětného volání

Jakmile je zpráva odeslána, síť vrátí stav DLR. Váš webhook koncový bod obdrží tento datový balíček, který obsahuje unikátní ID zprávy a konečný stavový kód. Engine IOSOR koreluje toto ID s původním záznamem transakce. Pokud stav indikuje úspěšné doručení, systém převede blokovanou částku na trvalý debet. Pokud stav indikuje selhání, blokace je uvolněna zpět do vašeho dostupného zůstatku, což zajišťuje, že platíte pouze za úspěšné pokusy.

Správa odsouhlasení účetní knihy

Odsouhlasení je automatizované, ale vývojáři musí sledovat latenci mezi odesláním a příchodem DLR. Pokud je DLR zpožděno, blokace zůstává aktivní, což může dočasně snížit váš dostupný kredit. Pro účty udržující minimální předplacený zůstatek USD 20 je to kritické pro zamezení přerušení služeb. Pokud váš měsíční objem překročí USD 1 000/měsíc, náš systém spustí kontrolu pro úpravu vašich úvěrových limitů a zajištění plynulé propustnosti pro vysokofrekvenční provoz.

Řešení okrajových případů a časových limitů

Ne všechny zprávy obdrží DLR v očekávaném časovém okně. Pokud síť neposkytne aktualizaci stavu, systém IOSOR využívá čisticí úlohu, která uvolňuje zastaralé blokace po definované době TTL (Time-To-Live). To zabraňuje 'duchovým' blokacím ovlivňovat vaši likviditu. Vždy zajistěte, aby váš webhook handler potvrdil přijetí DLR do 500 ms pro udržení synchronizace mezi naší účetní knihou a vašimi interními záznamy.

Základní integrační zdroje

Pro zajištění robustnosti vaší implementace a dodržování osvědčených postupů pro finanční integritu se podívejte na tyto příručky:

Začněte s IOSOR

Chcete-li dokončit integraci, přejděte do konzole IOSOR a v nastavení webhooků nakonfigurujte koncový bod pro odsouhlasení účetní knihy. Ujistěte se, že je váš listener připraven zpracovat datovou schránku "dlr.status" a mapovat ji přímo na odpovídající ID blokace transakce. Otestování této korelace v sandboxovém prostředí zaručí, že vyhrazené prostředky budou uvolněny nebo zaúčtovány okamžitě bez jakýchkoli odchylek v účetnictví.

Shrnutí IOSOR

Tato příručka ukázala, jak bezpečně překlenout mezeru mezi doručováním zpráv v reálném čase a přesností finančního účetnictví. Propojením příchozích zpětných volání DLR s aktivními předplacenými blokacemi zabráníte zbytečnému vázání kapitálu a zajistíte, že váš disponibilní zůstatek bude odrážet skutečný stav doručení namísto nejhorších možných scénářů.

Navrhněte svůj webhook handler tak, aby byl striktně idempotentní, což zajistí, že duplicitní DLR nespustí vícenásobné úpravy účetní knihy. Nespoléhejte se pouze na okamžitá zpětná volání; vždy implementujte záložní mechanismus TTL pro uvolnění zastaralých blokací, pokud operátor nevrátí potvrzení o doručení.

Byl tento průvodce užitečný?

Související průvodci