Corelarea webhook-urilor de stare DLR cu reținerile preplătite

Trimiterea de SMS prin IOSOR aplică o reținere în USD. Neprocesarea din webhook DLR blochează fondurile. Ajustarea JIT prin API rezolvă soldul.

Înțelegerea mecanismului de reținere preplătită

În ecosistemul IOSOR, fiecare cerere SMS de ieșire declanșează o verificare imediată a registrului de tip JIT (Just-In-Time). Când o cerere este inițiată, sistemul plasează o reținere temporară pe soldul contului pentru a asigura existența fondurilor suficiente pentru livrarea mesajului. Această reținere nu este un debit final, ci o rezervare de capital. Decontarea finală are loc doar la primirea stării DLR (Delivery Receipt) de la rețea, asigurându-se că registrul tău financiar reflectă cu exactitate consumul real de credite de mesagerie.

Ciclul de viață al unui callback DLR

Odată ce un mesaj este expediat, rețeaua returnează o stare DLR. Endpoint-ul tău webhook primește acest payload, care conține ID-ul unic al mesajului și codul de stare final. Motorul IOSOR corelează acest ID cu înregistrarea tranzacției originale. Dacă starea indică o livrare reușită, sistemul convertește suma reținută într-un debit permanent. Dacă starea indică o eroare, reținerea este eliberată înapoi în soldul tău disponibil, asigurându-te că plătești doar pentru încercările reușite.

Gestionarea reconcilierii registrului

Reconcilierea este automatizată, dar dezvoltatorii trebuie să monitorizeze latența dintre expediere și sosirea DLR. Dacă un DLR întârzie, reținerea rămâne activă, ceea ce poate reduce temporar creditul disponibil. Pentru conturile care mențin un prag minim preplătit de USD 20, acest lucru este critic pentru a evita întreruperile serviciului. Dacă volumul tău lunar depășește USD 1.000/lună, sistemul nostru declanșează o revizuire pentru a ajusta limitele de credit și a asigura un flux fluid pentru traficul de înaltă frecvență.

Gestionarea cazurilor limită și a timeout-urilor

Nu toate mesajele primesc un DLR în fereastra de timp așteptată. Dacă o rețea nu furnizează o actualizare de stare, sistemul IOSOR utilizează o sarcină de curățare care eliberează reținerile expirate după un TTL (Time-To-Live) definit. Acest lucru previne ca reținerile 'fantomă' să afecteze lichiditatea ta. Asigură-te întotdeauna că handler-ul tău webhook confirmă primirea DLR în 500ms pentru a menține sincronizarea între registrul nostru și evidențele tale contabile interne.

Resurse esențiale de integrare

Pentru a te asigura că implementarea ta este provenă și respectă cele mai bune practici pentru integritatea financiară, consultă aceste ghiduri:

• Ordinea evenimentelor față de înregistrarea în ledger
• Un webhook duplicat nu trebuie să creeze un al doilea debit
• idempotență, reîncercări și bani.

Începeți cu IOSOR

Pentru a finaliza integrarea, accesați IOSOR Console și navigați la Webhook Settings pentru a configura endpoint-ul de reconciliere a registrului. Asigurați-vă că receptorul dvs. este pregătit să proceseze sarcina utilă dlr.status și să o asocieze direct cu ID-ul de blocare a tranzacției corespunzător. Testarea acestei corelații în mediul sandbox va garanta că fondurile rezervate sunt eliberate sau debitate instantaneu, fără decalaje în registru.

Rezumat IOSOR

Acest ghid a demonstrat cum să corelați în siguranță livrarea mesajelor în timp real cu acuratețea registrului financiar. Prin corelarea apelurilor inverse DLR primite cu blocările prepaid active, preveniți blocarea capitalului și vă asigurați că soldul disponibil reflectă stările reale de livrare, nu estimările cele mai pesimiste.