IOSOR

IOSOR Panduan

Pengiriman pengguna akhir tetap mendebit satu buku besar prabayar

Embedded Send tetap mendebit dompet prabayar ISV. Jangan membuat buku besar kedua yang tidak didanai produk — hold, retry, dan idempotensi tetap jujur.

Pesan tersemat terasa gratis bagi pengguna akhir: mereka mengklik Kirim di dalam UI SaaS dan melihat tanda centang hijau. Di balik layar, setiap pengiriman yang berhasil tetap mendebit satu buku besar prabayar milik ISV. Tidak ada dompet kedua yang muncul hanya karena produk menyematkan API. Jika ISV tidak mendanai penahanan, pengiriman harus gagal dengan kesalahan produk yang jujur — bukan status terkirim palsu.

Akuntansi fiktif adalah penyebab kegagalan: pengukur kredit dalam aplikasi yang tidak didukung oleh dompet IOSOR, pengembalian dana SaaS saat buku besar prabayar terkuras, atau percobaan ulang tanpa idempotensi yang mendebit ganda satu OTP. Penyematan menyembunyikan konsol; ISV tetap menjadi pihak yang mendanai.

Garis dokumen arsitektur: pengiriman pengguna akhir ≡ debit prabayar ISV. Setiap peninjauan desain dimulai dari sana.

Satu buku besar, meskipun UI menampilkan kredit produk

Paket pesan yang dijual ke penyewa adalah lapisan komersial ISV. Paket tersebut harus dipetakan ke penahanan dan debit prabayar pada satu dompet IOSOR yang didanai ISV. Saldo penyewa yang tidak pernah direkonsiliasi ke baris buku besar adalah bom utang dukungan. Ekspor penggunaan penyewa mingguan terhadap baris dompet agar tim keuangan melihat pengeluaran yang sama dengan produk.

Penahanan dan idempotensi tetap berlaku pada jalur embed

Pengiriman dari sisi server harus menggunakan kunci idempotensi untuk OTP dan SMS transaksional. Klik ganda di UI SaaS tidak boleh membuat dua debit untuk satu tindakan pengguna. Percobaan ulang setelah waktu habis mengikuti kunci yang sama hingga DLR terminal atau kegagalan yang dipetakan.

Petakan kesalahan produk ke kebenaran buku besar

Sinyal UI SaaS Kebenaran buku besar Langkah selanjutnya yang diizinkan
Terkirim / tersampaikan Debit + jalur DLR ada Tampilkan ID tanda terima
Dalam antrean Penahanan terbuka atau pengajuan diterima Periksa status
Gagal / dijeda Penahanan ditolak atau gerbang penghentian C.

Serah terima saluran tetap berada di dompet yang sama

Jika produk kemudian menambahkan email atau suara di samping SMS, pengeluaran tetap bermuara pada buku besar prabayar yang sama kecuali Anda menjalankan serah terima saluran kedua dengan persetujuan keuangan. Penyematan tidak membuat saluran sampingan gratis. Baca Kedekatan Dompet sebelum mengaktifkan ubin Live lainnya di pengaturan SaaS.

Jalur operasional terkait

Mulai dengan IOSOR

Buka Konsol IOSOR dan petakan sistem kredit penyewa Anda langsung ke buku besar dompet prabayar utama. Pastikan semua permintaan sematan sisi server melewati kunci idempoten deterministik sebelum menahan dompet master. Konfigurasikan titik akhir webhook Anda untuk memproses DLR masuk agar penahanan terbuka diselesaikan secara bersih ke debit atau pelepasan buku besar akhir.

Intisari IOSOR

Antarmuka SaaS tersemat dapat menyajikan kredit pesan kustom kepada pengguna akhir, tetapi setiap pengiriman nyata terikat pada satu dompet prabayar yang didanai oleh ISV. Percobaan ulang, perluasan saluran, dan sinyal status pengguna harus direkonsiliasi secara langsung terhadap penahanan dompet daripada abstraksi antarmuka pengguna yang tidak didukung. Tegakkan kunci idempoten sisi server yang ketat dan petakan setiap status UI penyewa ke respons DLR buku besar yang sebenarnya. Jangan menciptakan dompet sekunder yang tidak didukung atau mengizinkan percobaan ulang UI penyewa dieksekusi tanpa penahanan buku besar yang konkret.

Apakah panduan ini membantu?

Panduan terkait