DLR állapotú webhookok korrelációja az előre fizetett zárolásokkal

Minden IOSOR rendszerből indított SMS egy ideiglenes USD zárolást képez a számlaegyenlegen. A beérkező DLR webhook értesítések és a zárolások hibás korrelációja tőkelefagyáshoz vezethet. Használjon JIT elszámolást az API-n keresztül a zárolt összeg pontos kezeléséhez.

Az előre fizetett zárolási mechanizmus megértése

Az IOSOR ökoszisztémában minden kimenő SMS-kérés azonnali JIT (Just-In-Time) főkönyvi ellenőrzést vált ki. Amikor egy kérés elindul, a rendszer ideiglenes zárolást helyez a számlaegyenlegre, hogy biztosítsa a megfelelő fedezetet az üzenet kézbesítéséhez. Ez a zárolás nem végleges terhelés, hanem tőkelekötés. A végső elszámolás csak a hálózattól érkező DLR (kézbesítési visszaigazolás) állapotának kézhezvételekor történik meg, biztosítva, hogy a pénzügyi főkönyve pontosan tükrözze az üzenetküldési kreditek tényleges felhasználását.

A DLR visszahívás életciklusa

Az üzenet elküldése után a hálózat visszaküld egy DLR állapotot. A webhook végpontja megkapja ezt a hasznos adatot, amely tartalmazza az egyedi üzenetazonosítót és a végső állapotkódot. Az IOSOR motorja korrelálja ezt az azonosítót az eredeti tranzakciós rekorddal. Ha az állapot sikeres kézbesítést jelez, a rendszer a zárolt összeget végleges terheléssé alakítja. Ha az állapot hibát jelez, a zárolás felszabadul a rendelkezésre álló egyenlegedre, biztosítva, hogy csak a sikeres kísérletekért fizess.

Főkönyvi egyeztetés kezelése

Az egyeztetés automatizált, de a fejlesztőknek figyelniük kell az elküldés és a DLR érkezése közötti késleltetést. Ha egy DLR késik, a zárolás aktív marad, ami átmenetileg csökkentheti a rendelkezésre álló hitelkeretedet. Azoknál a számláknál, amelyek USD 20 előre fizetett alsó korlátot tartanak fenn, ez kritikus a szolgáltatás megszakadásának elkerülése érdekében. Ha a havi forgalmad meghaladja az USD 1 000/hó értéket, rendszerünk felülvizsgálatot indít a hitelkeretek módosítása és a nagyfrekvenciás forgalom zökkenőmentes átbocsátása érdekében.

Peremesetek és időtúllépések kezelése

Nem minden üzenet kap DLR-t a várt időablakon belül. Ha egy hálózat nem biztosít állapotfrissítést, az IOSOR rendszer egy tisztítási feladatot futtat, amely felszabadítja az elavult zárolásokat egy meghatározott TTL (Time-To-Live) idő után. Ez megakadályozza, hogy a 'szellem' zárolások befolyásolják a likviditásodat. Mindig győződj meg róla, hogy a webhook kezelőd 500 ms-on belül nyugtázza a DLR érkezését a főkönyvünk és a belső könyvelési nyilvántartásaid közötti szinkronizáció fenntartása érdekében.

Alapvető integrációs források

Annak biztosítása érdekében, hogy a megvalósításod robusztus legyen és megfeleljen a pénzügyi integritás legjobb gyakorlatainak, tekintsd meg ezeket az útmutatókat:

• Események sorrendje vs. főkönyvi könyvelés
• A duplikált webhook nem hozhat létre második terhelést
• idempotencia, újrapróbálás és pénz

Kezdje az IOSOR-ral

Az integráció véglegesítéséhez lépjen az IOSOR Konzolra, és a Webhook Beállítások menüpontban konfigurálja a főkönyvi egyeztetési végpontot. Győződjön meg arról, hogy a fogadó készen áll a dlr.status adatcsomag feldolgozására, és közvetlenül hozzárendeli azt a megfelelő tranzakciós zárolási azonosítóhoz (hold ID). Ezen összefüggés tesztelése a sandbox környezetben garantálja, hogy a lefoglalt egyenlegek azonnal felszabadulnak vagy levonásra kerülnek főkönyvi eltérések nélkül.

IOSOR összegzés

Ez az útmutató bemutatta, hogyan hidalható át biztonságosan a valós idejű üzenetkézbesítés és a pénzügyi főkönyv pontossága közötti szakadék. A beérkező DLR visszahívások és az aktív prepaid zárolások összekapcsolásával megelőzheti a tőke szükségtelen lekötését, és biztosíthatja, hogy a rendelkezésre álló egyenleg a tényleges kézbesítési állapotokat tükrözze a legrosszabb forgatókönyveken alapuló feltételezések helyett.