IOSOR Panduan

Penghantaran pengguna akhir tetap mendebit satu lejar prabayar

Embedded Send tetap mendebit dompet prabayar ISV. Jangan reka lejar kedua yang tidak dibiayai produk — penahanan, percubaan semula dan idempotensi kekal telus.

Pemasangan mesej terbenam terasa percuma bagi pengguna akhir: mereka mengetik Hantar di dalam antaramuka SaaS dan melihat tanda semak hijau. Di sebalik tabir, setiap penghantaran yang berjaya tetap mendebit satu lejar prabayar milik ISV. Tiada dompet kedua yang muncul disebabkan produk menanam API. Jika ISV tidak membiayai penahanan, penghantaran mesti gagal dengan ralat produk yang betul — bukannya status terhantar palsu.

Perakaunan fiksyen adalah punca kegagalan: meter kredit dalam aplikasi yang tidak disokong oleh dompet IOSOR, pemulangan wang SaaS semasa lejar prabayar menyusut, atau percubaan semula tanpa idempotensi yang mendebit ganda satu OTP. Embed menyembunyikan konsol; ISV kekal sebagai pihak yang membiayai.

Garisan dokumen seni bina: penghantaran pengguna akhir ≡ debit prabayar ISV. Setiap semakan reka bentuk bermula di situ.

Satu lejar, walaupun UI menunjukkan kredit produk

Pakej mesej yang dijual kepada penyewa merupakan lapisan komersial ISV. Pakej tersebut mesti dipetakan kepada penahanan dan debit prabayar pada satu dompet IOSOR yang dibiayai oleh ISV. Baki penyewa yang tidak pernah diselaraskan dengan baris lejar adalah beban sokongan. Eksport penggunaan penyewa setiap minggu terhadap baris dompet supaya bahagian kewangan melihat pengurangan yang sama seperti produk.

Penahanan dan idempotensi tetap terikat pada laluan embed

Penghantaran sebelah pelayan mesti menggunakan kunci idempotensi untuk OTP dan SMS transaksi. Klik dua kali dalam antaramuka SaaS tidak boleh mencipta dua debit untuk satu tindakan pengguna. Percubaan semula selepas tamat masa mengikut kunci yang sama sehingga DLR terminal atau ralat yang dipetakan.

Peta ralat produk kepada kebenaran lejar

Isyarat UI SaaS Kebenaran lejar Langkah seterusnya yang dibenarkan
Dihantar / disampaikan Debit + laluan DLR wujud Tunjukkan ID resit
Dalam barisan Penahanan terbuka atau serahan diterima Semak status
Gagal / dijeda Penahanan ditolak atau halangan.

Penyerahan saluran kekal pada dompet yang sama

Jika produk kemudiannya menambah e-mel atau suara bersebelahan SMS, perbelanjaan tetap berada pada lejar prabayar yang sama melainkan anda menjalankan penyerahan saluran kedua dengan kelulusan kewangan. Embed tidak mencipta saluran sampingan percuma. Baca Kedekatan Dompet sebelum mengaktifkan jubin Live lain dalam tetapan SaaS.

Laluan operasi berkaitan

Mulakan dengan IOSOR

Buka Konsol IOSOR dan petakan sistem kredit penyewa anda terus ke lejar dompet prabayar utama. Pastikan semua permintaan benam bahagian pelayan melepasi kunci ketidempotenan deterministik sebelum meletakkan pegangan pada dompet induk. Konfigurasikan titik akhir webhook anda untuk memproses DLR yang masuk supaya pegangan terbuka diselesaikan secara bersih kepada debit atau pelepasan lejar akhir.

Inti IOSOR

Antara muka SaaS terbenam boleh mempersembahkan kredit mesej tersuai kepada pengguna akhir, tetapi setiap penghantaran sebenar terikat pada dompet prabayar tunggal yang dibiayai oleh ISV. Percubaan semula, pengembangan saluran dan isyarat status pengguna mesti diselaraskan terus terhadap pegangan dompet berbanding pen abstrak UI yang tidak disokong.

Kuatkuasakan kunci ketidempotenan bahagian pelayan yang ketat dan petakan setiap keadaan UI penyewa kepada tindak balas DLR lejar yang benar. Jangan cipta dompet sekunder yang tidak disokong atau benarkan percubaan semula UI penyewa dilaksanakan tanpa pegangan lejar yang konkrit.

Adakah panduan ini membantu?

Panduan berkaitan