IOSOR Gabay
Ang pagpapadala ng end-user ay bumabawas pa rin sa iisang prepaid ledger
Ang embedded send ay nagde-debit pa rin sa ISV prepaid wallet. Huwag mag-imbento ng pangalawang ledger na hindi pinopondohan ng produkto — ang mga hold, retry, at idempotency ay dapat manatiling tapat.
Ang embedded messaging ay mukhang libre para sa end user: nag-tap sila ng Send sa loob ng SaaS UI at nakakakita ng berdeng check mark. Sa ilalim ng ibabaw, ang bawat matagumpay na pagpapadala ay nagde-debit pa rin sa iisang prepaid ledger na pagmamay-ari ng ISV. Walang pangalawang wallet na lumilitaw dahil lang sa nag-embed ang produkto ng isang API. Kung hindi pinopondohan ng ISV ang mga hold, ang pagpapadala ay dapat mabigo sa isang tapat na error sa produkto — hindi sa isang pekeng delivered na status.
Iisang ledger, kahit na nagpapakita ang UI ng mga credit ng produkto
Ang mga message pack na ibinebenta sa mga tenant ay isang komersyal na layer ng ISV. Dapat silang mag-map sa mga prepaid hold at debit sa iisang IOSOR wallet na pinopondohan ng ISV. Ang balanse ng tenant na hindi kailanman nagtutugma sa mga linya ng ledger ay isang malaking problema sa suporta. I-export ang paggamit ng tenant linggo-linggo laban sa mga linya ng wallet upang makita ng finance ang parehong paggastos na nakikita ng produkto.
Ang mga hold at idempotency ay nagpapatupad pa rin sa mga embedded path
Ang pagpapadala sa panig ng server ay kailangang gumamit ng mga idempotency key para sa OTP at transactional SMS. Ang dalawang beses na pag-click sa SaaS UI ay hindi dapat lumikha ng dalawang debit para sa iisang aksyon ng user. Ang mga retry pagkatapos ng timeout ay sumusunod sa parehong key hanggang sa isang terminal DLR o na-map na kabiguan.
I-map ang mga error ng produkto sa katotohanan ng ledger
| Signal sa SaaS UI | Katotohanan ng ledger | Pinapayagáng kasunod na hakbang |
|---|---|---|
| Naisadala / naihatid | May umiiral na debit + DLR path | Ipakita ang receipt id |
| Nakapila | Nakatabi ang hold o tinanggap | I-poll ang status |
| Nabigo / nakatigil | Tinanggihan ang hold o nakasara | Subukang muli gamit ang bago. |
Ang paglipat ng channel ay nananatili sa parehong wallet
Kung magdaragdag ang produkto ng email o boses bukod sa SMS sa hinaharap, ang paggastos ay napupunta pa rin sa parehong prepaid ledger maliban kung magpapatakbo ka ng pangalawang channel handover na may pag-apruba ng finance. Ang embed ay hindi lumilikha ng libreng karagdagang channel. Basahin ang tungkol sa adjacency ng wallet bago magbukas ng bagong live tile sa mga setting ng SaaS.
Mga kaugnay na ops path
- Pangalawang channel sa wallet: spend handover
- idempotency, retry, at pera
- Ligtas na pagpapatupad ng mga limitasyon sa rate sa mga multi-tenant account
Magsimula sa IOSOR
Buksan ang Konsol ng IOSOR at itugma ang sistema ng kredito ng iyong nangungupahan nang direkta sa pangunahing prepaid na ledger ng pitaka. Tiyaking ang lahat ng kahilingan sa panig ng server ay nagpapasa ng isang deterministikong susi ng pagiging natatangi bago maglagay ng hawak sa pangunahing pitaka. I-configure ang iyong webhook endpoint upang iproseso ang mga papasok na DLR upang ang mga bukas na hawak ay malinis na malutas sa mga huling debit o pagpapalabas ng ledger.
Buod ng IOSOR
Ang isang naka-embed na interface ng SaaS ay maaaring magpakita ng mga pasadyang kredito ng mensahe sa mga end-user, ngunit ang bawat tunay na pagpapadala ay nakatali sa iisang prepaid na ledger na pinopondohan ng ISV. Ang mga pagsubok muli, pagpapalawak ng channel, at mga senyales ng katayuan ng gumagamit ay dapat direktang magkasundo laban sa mga hawak ng pitaka sa halip na mga abstraction ng UI na walang suporta.
Ipatupad ang mahigpit na mga susi ng pagiging natatangi sa panig ng server at itugma ang bawat estado ng UI ng nangungupahan sa mga tunay na tugon ng DLR ng ledger. Huwag gumawa ng mga pangalawang pitaka na walang suporta o payagan ang mga pagsubok muli ng UI ng nangungupahan na isagawa nang walang konkretong hawak sa ledger.
Nakatulong ba ang gabay na ito?
Mga kaugnay na gabay
- Pag-embed ng API laban sa portal ng partner na white-label
Ang mga produktong SaaS na nag-e-embed ng messaging ay nananatili sa ibabaw ng ISV. Ang mga portal ng partner na white-label ay nananatili sa ilalim ng Partner — huwag paghaluin ang brand at mga key.
- Kapag ang limitasyon ng embedded tenant ay kailangang magpatigil ng pagpapadala
Ang mga fair-share cap sa loob ng produkto ng ISV ay kailangang mag-hard-stop ng pagpapadala para sa tenant na iyon — huwag kailanman magbalik ng pekeng delivered API 200 kapag naabot ang limitasyon.