Mengkorelasikan Webhook Status DLR dengan Penahanan Saldo Prabayar

Saat mengirim OTP SMS lewat IOSOR, saldo Anda akan ditahan sementara sebagai jaminan. Kegagalan mengorelasikan webhook DLR dengan penahanan ini dapat menyebabkan saldo terkunci dan data ledger tidak akurat. Gunakan alur rekonsiliasi JIT via API kami untuk memastikan dana didebit atau dikembalikan secara otomatis berdasarkan status pengiriman akhir.

Memahami mekanisme penahanan saldo prabayar

Dalam ekosistem IOSOR, setiap permintaan SMS keluar memicu pemeriksaan ledger JIT (Just-In-Time) secara instan. Saat permintaan dimulai, sistem menempatkan penahanan sementara pada saldo akun untuk memastikan dana yang cukup tersedia untuk pengiriman pesan. Penahanan ini bukan debit akhir, melainkan reservasi modal. Penyelesaian akhir terjadi hanya setelah menerima status DLR (Delivery Receipt) dari jaringan, memastikan bahwa ledger keuangan Anda mencerminkan konsumsi kredit pesan yang sebenarnya secara akurat.

Siklus hidup callback DLR

Setelah pesan dikirim, jaringan mengembalikan status DLR. Endpoint webhook Anda menerima payload ini, yang berisi ID pesan unik dan kode status akhir. Mesin IOSOR mengkorelasikan ID ini dengan catatan transaksi asli. Jika status menunjukkan pengiriman berhasil, sistem mengubah jumlah yang ditahan menjadi debit permanen. Jika status menunjukkan kegagalan, penahanan dilepaskan kembali ke saldo Anda yang tersedia, memastikan Anda hanya membayar untuk upaya yang berhasil.

Mengelola rekonsiliasi ledger

Rekonsiliasi bersifat otomatis, tetapi pengembang harus memantau latensi antara pengiriman dan kedatangan DLR. Jika DLR tertunda, penahanan tetap aktif, yang dapat mengurangi kredit tersedia Anda untuk sementara. Untuk akun yang mempertahankan batas bawah prabayar USD 20, ini sangat penting untuk mencegah gangguan layanan. Jika volume bulanan Anda melebihi USD 1.000/bulan, sistem kami memicu peninjauan ringan untuk menyesuaikan batas kredit Anda dan memastikan throughput yang lancar untuk lalu lintas frekuensi tinggi.

Menangani kasus tepi dan timeout

Tidak semua pesan menerima DLR dalam jendela yang diharapkan. Jika jaringan gagal memberikan pembaruan status, sistem IOSOR menggunakan pekerjaan pembersihan yang melepaskan penahanan basi setelah TTL (Time-To-Live) yang ditentukan. Ini mencegah penahanan 'hantu' memengaruhi likuiditas Anda. Selalu pastikan handler webhook Anda mengakui penerimaan DLR dalam 500ms untuk menjaga sinkronisasi antara ledger kami dan catatan akuntansi internal Anda.

Sumber daya integrasi penting

Untuk memastikan implementasi Anda kuat dan mengikuti praktik terbaik untuk integritas keuangan, lihat panduan berikut:

• Urutan kejadian versus pencatatan ledger
• Webhook duplikat tidak boleh memicu debit kedua
• idempotensi, coba ulang, dan uang

Mulai dengan IOSOR

Untuk menyelesaikan integrasi Anda, buka Konsol IOSOR dan navigasikan ke Pengaturan Webhook untuk mengonfigurasi endpoint rekonsiliasi buku besar Anda. Pastikan listener Anda siap memproses payload dlr.status dan memetakannya secara langsung ke ID penahanan transaksi yang sesuai. Menguji korelasi ini di lingkungan sandbox akan menjamin bahwa dana yang dicadangkan dilepaskan atau didebit secara instan tanpa adanya selisih buku besar.

Intisari IOSOR

Panduan ini mendemonstrasikan cara menjembatani celah antara pengiriman pesan waktu nyata dan akurasi buku besar keuangan secara aman. Dengan menghubungkan callback DLR yang masuk dengan penahanan prabayar yang aktif, Anda mencegah pembekuan modal dan memastikan bahwa saldo yang tersedia mencerminkan status pengiriman aktual, bukan asumsi terburuk.