IOSOR

IOSOR Panduan

Mengkorelasikan Webhook Status DLR dengan Pegangan Prabayar

Ketahui cara menyelaraskan callback resit penghantaran dengan dana prabayar yang dipegang untuk melepaskan jumlah lejar yang dikhaskan dalam infrastruktur IOSOR CPaaS.

Setiap penghantaran OTP SMS melalui IOSOR akan menahan baki USD anda buat sementara waktu. Kegagalan mengaitkan webhook DLR dengan pegangan ini boleh menyebabkan modal terperangkap dan lejar tidak tepat. Laksanakan aliran penyelarasan JIT melalui API kami bagi memastikan dana didebit atau dikembalikan secara automatik berdasarkan status penghantaran akhir.

Memahami mekanisme pegangan prabayar

Dalam ekosistem IOSOR, setiap permintaan SMS keluar mencetuskan semakan lejar JIT (Just-In-Time) serta-merta. Apabila permintaan dimulakan, sistem meletakkan pegangan sementara pada baki akaun untuk memastikan dana yang mencukupi wujud untuk penghantaran mesej. Pegangan ini bukan debit akhir tetapi tempahan modal. Penyelesaian akhir berlaku hanya setelah menerima status DLR (Delivery Receipt) daripada rangkaian, memastikan lejar kewangan anda mencerminkan penggunaan kredit pemesejan sebenar dengan tepat.

Kitaran hayat callback DLR

Setelah mesej dihantar, rangkaian mengembalikan status DLR. Endpoint webhook anda menerima payload ini, yang mengandungi ID mesej unik dan kod status akhir. Enjin IOSOR mengkorelasikan ID ini dengan rekod transaksi asal. Jika status menunjukkan penghantaran berjaya, sistem menukarkan jumlah yang dipegang menjadi debit kekal. Jika status menunjukkan kegagalan, pegangan dilepaskan kembali ke baki tersedia anda, memastikan anda hanya membayar untuk percubaan yang berjaya.

Menguruskan penyelarasan lejar

Penyelarasan adalah automatik, tetapi pembangun mesti memantau kependaman antara penghantaran dan ketibaan DLR. Jika DLR tertangguh, pegangan kekal aktif, yang mungkin mengurangkan kredit tersedia anda buat sementara waktu. Bagi akaun yang mengekalkan lantai prabayar USD 20, ini adalah kritikal untuk mengelakkan gangguan perkhidmatan. Jika volum bulanan anda melebihi USD 1.000/bulan, sistem kami mencetuskan semakan lembut untuk melaraskan had kredit anda dan memastikan throughput yang lancar untuk trafik frekuensi tinggi.

Mengendalikan kes tepi dan tamat masa

Tidak semua mesej menerima DLR dalam tetingkap yang dijangkakan. Jika rangkaian gagal memberikan kemas kini status, sistem IOSOR menggunakan kerja pembersihan yang melepaskan pegangan basi selepas TTL (Time-To-Live) yang ditetapkan. Ini menghalang pegangan 'hantu' daripada menjejaskan kecairan anda. Sentiasa pastikan pengendali webhook anda mengakui penerimaan DLR dalam masa 500ms untuk mengekalkan penyegerakan antara lejar kami dan rekod perakaunan dalaman anda.

Sumber integrasi penting

Untuk memastikan pelaksanaan anda teguh dan mengikut amalan terbaik untuk integriti kewangan, rujuk panduan ini:

Mulakan dengan IOSOR

Untuk melengkapkan integrasi anda, layari Konsol IOSOR dan pergi ke Tetapan Webhook untuk mengkonfigurasi titik akhir penyelarasan lejar anda. Pastikan pendengar anda bersedia untuk memproses muatan dlr.status dan memetakan terus ke ID sekatan transaksi yang sepadan. Menguji korelasi ini dalam persekitaran sandbox akan memastikan dana yang dikhaskan dilepaskan atau didebit serta-merta tanpa sebarang hanyutan lejar.

Inti IOSOR

Panduan ini menunjukkan cara merapatkan jurang dengan selamat antara penghantaran mesej masa nyata dan ketepatan lejar kewangan. Dengan mengaitkan panggilan balik DLR yang masuk dengan sekatan prabayar aktif, anda mengelakkan pembekuan modal dan memastikan baki tersedia anda mencerminkan status penghantaran sebenar berbanding andaian terburuk.

Adakah panduan ini membantu?

Panduan berkaitan