IOSOR Znalosti

Odeslání koncovým uživatelem stále čerpá z jedné předplacené hlavní knihy

Integrované odesílání stále debetuje předplacenou peněženku ISV. Nevymýšlejte druhou hlavní knihu, kterou produkt nefinancuje.

Integrované zprávy působí pro koncového uživatele zdarma: klepnou na Odeslat v rozhraní SaaS a uvidí zelenou fajfku. Pod povrchem však každé úspěšné odeslání stále naráží na jednu předplacenou hlavní knihu vlastněnou ISV. Neexistuje žádná druhá peněženka jen proto, že produkt integroval API. Pokud ISV nefinancuje blokace, odeslání musí selhat s poctivou chybou produktu — nikoli s fiktivním stavem doručení.

Fiktivní účetnictví je chybovým stavem: ukazatel kreditů v aplikaci nekrytý peněženkou IOSOR, refundace SaaS zatímco hlavní kniha ubývá, nebo opakování bez idempotence, která dvakrát debetují jedno OTP. Integrace skrývá konzoli; ISV zůstává financující stranu.

Architektonická zásada: odeslání koncovým uživatelem ≡ předplacený debet ISV. Každá revize návrhu začíná tam.

Jedna hlavní kniha, i když UI zobrazuje kredit produktu

Balíčky zpráv prodávané nájemcům jsou komerční vrstvou ISV. Musí odpovídat předplaceným blokacím a debetům na jediné peněžence IOSOR, kterou ISV financuje. Zůstatek nájemce, který se nikdy neodsouhlasí s řádky hlavní knihy, je časovanou bombou pro podporu. Exportujte využití nájemců týdně oproti řádkům peněženky, aby finance viděly stejný úbytek jako produkt.

Blokace a idempotence stále platí na integrovaných cestách

Odesílání na straně serveru musí používat klíče idempotence pro OTP a transakční SMS. Dvojité kliknutí v rozhraní SaaS nesmí vytvořit dva debety pro jednu akci uživatele. Opakování po vypršení časového limitu sleduje stejný klíč až do finálního DLR nebo mapované chyby.

Pokud peněženka nemůže provést blokaci, vraťte stav nedostatečných prostředků nebo pozastaveného odesílání. Nikdy nevracejte HTTP 200 s doručeným výsledek, pokud blokace selhala.

Mapujte chyby produktu na pravdu v hlavní knize

Signál v SaaS UI Pravda v hlavní knize Povolený další krok
Odesláno / doručeno Debet + DLR cesta existuje Zobrazit ID potvrzení
V frontě Blokace otevřena nebo přijata Dotazovat stav
Selhalo / pozastaveno Blokace odmítnuta nebo spuštěna stopka Opakovat pouze s novým záměrem
Falešný úspěch Bez debetu.

Předání kanálů zůstává na stejné peněžence

Pokud produkt později přidá e-mail nebo hlas vedle SMS, útrata stále dopadá na stejnou hlavní knihu, pokud neprovedete předání druhého kanálu se schválením financí. Integrace nevytváří bezplatný vedlejší kanál. Přečtěte si o sousedství peněženky před zapnutím další dlaždice Live v nastavení SaaS.

Související provozní cesty

Začněte s IOSOR

Otevřete konzoli IOSOR a namapujte systém kreditů vašeho tenanta přímo na hlavní účetní knihu předplacené peněženki. Zajistěte, aby všechny požadavky na vložení na straně serveru předcházelo předání deterministického klíče idempotence před vytvořením blokace na hlavní peněžence. Konfigurujte koncový bod webhooku tak, aby zpracovával příchozí doručenky, takže otevřené blokace budou čistě vyřešeny na finální debety nebo uvolnění peněžní knihy.

Shrnutí IOSOR

Integrované rozhraní SaaS může koncovým uživatelům zobrazovat vlastní kredity zpráv, avšak každé skutečné odeslání se váže k jediné předplacené knize financované nezávislým dodavatelem softwaru. Opakované pokusy, rozšíření kanálů a signály stavu uživatele se musí vyrovnávat přímo vůči blokacím peněženky, nikoli vůči nepodloženým uživatelským abstrakcím.

Prosazujte přísné klíče idempotence na straně serveru a mapujte každý stav uživatelského rozhraní tenanta na skutečné odpovědi doručenek z knihy. Nevytvářejte nepodložené sekundární peněženky ani nepovolujte opakování akcí v rozhraní tenanta bez konkrétních blokací v knize.

Byl tento průvodce užitečný?

Související průvodci