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
- Saluran kedua pada dompet: penyerahan perbelanjaan
- idempotensi, cuba semula dan wang
- Menguatkuasakan Had Kadar Secara Selamat untuk Akaun Berbilang Penyewa
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
- Penyerapan API berbanding portal rakan kongsi label putih
Produk SaaS yang menyerap mesej kekal pada permukaan ISV. Portal rakan kongsi label putih kekal di bawah Rakan Kongsi — jangan campur adukkan jenama, kunci dan pemilikan operasi.
- Apabila had penyewa terbenam mesti menghentikan hantaran
Had perkongsian adil dalam produk ISV mesti menghentikan hantaran secara mutlak untuk penyewa tersebut — jangan pernah mengembalikan API 200 terkirim palsu apabila had dicapai.