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
- Druhý kanál na peněžence: předání útraty
- idempotence, opakování a peníze
- Vynucování limitů rychlosti napříč multi-tenant účty
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
- Vstupování API vs. partnerský portál white-label
SaaS produkty, které vkládají zprávy, zůstávají v rozhraní ISV. Partnerské portály white-label patří pod sekci Partner — nemíchejte značku, klíče a vlastníky.
- Kdy musí limit embedded tenanta zastavit odesílání
Limity fair-share uvnitř produktu ISV musí natvrdo zastavit odesílání pro daného tenanta — nikdy nevracet falešné API 200 delivered.