IOSOR Vedomosti
Odoslanie koncovým používateľom stále čerpá z jednej predplatenej hlavnej knihy
Integrované odosielanie stále debetuje predplatenú peňaženku ISV. Nevymýšľajte druhú hlavnú knihu, ktorú produkt nefinancuje.
Integrované správy pôsobia pre koncového používateľa bezplatne: ťuknú na Odoslať v rozhraní SaaS a uvidia zelenú kvačku. Pod povrchom však každé úspešné odoslanie stále naráža na jednu predplatenú hlavnú knihu vlastnícku ISV. Neexistuje žiadna druhá peňaženka len preto, že produkt integroval API. Ak ISV nefinancuje blokácie, odoslanie musí zlyhať s poctivou chybou produktu — nie s fiktívnym stavom doručenia.
Fiktívne účtovníctvo je chybovým stavom: ukazovateľ kreditov v aplikácii nekrytý peňaženkou IOSOR, SaaS refundácie kým hlavná kniha ubúda, alebo opakovania bez idempotencie, ktoré dvakrát debetujú jedno OTP. Integrácia skrýva konzolu; ISV zostáva financujúcou stranou.
Architektonická zásada: odoslanie koncovým používateľom ≡ predplatený debet ISV. Každá revízia návrhu začína tam.
Jedna hlavná kniha, aj keď UI zobrazuje kredity produktu
Balíky správ predávané nájomcom sú komerčnou vrstvou ISV. Musia zodpovedať predplateným blokáciám a debetom na jedinej peňaženke IOSOR, ktorú ISV financuje. Zostatok nájomcu, ktorý sa nikdy neodsúhlasí s riadkami hlavnej knihy, je časovanou bombou pre podporu. Exportujte využitie nájomcov týždenne oproti riadkom peňaženky, aby financie videli rovnaké čerpanie ako produkt.
Blokácie a idempotencia stále platia na integrovaných cestách
Odosielanie na strane servera musí používať kľúče idempotencie pre OTP a transakčné SMS. Dvojité kliknutie v rozhraní SaaS nesmie vytvoriť dva debety pre jednu akciu používateľa. Opakovania po vypršaní časového limitu sledujú rovnaký kľúč až do finálneho DLR alebo mapovanej chyby.
Mapujte chyby produktu na pravdu v hlavnej knihe
| Signál v SaaS UI | Pravda v hlavnej knihe | Povolený ďalší krok |
|---|---|---|
| Odoslané / doručené | Debet + DLR cesta existuje | Zobraziť ID potvrdenia |
| V poradí | Blokácia otvorená alebo prijatá | Dopytovať stav |
| Zlyhalo / pozastavené | Blokácia odmietnutá alebo spustená stopka | Opakovať len s novým zámerom |
| Falošný úspech | Bez debetu / bez bl. |
Odovzdania kanálov zostávajú na rovnakej peňaženke
Ak produkt neskôr pridá e-mail alebo hlas vedľa SMS, výdavky stále dopadajú na rovnakú hlavnú knihu, pokiaľ nevykonáte odovzdanie druhého kanála so schválením financií. Integrácia nevytvára bezplatný vedľajší kanál. Prečítajte si o susedstve peňaženky pred zapnutím ďalšej dlaždice Live v nastaveniach SaaS.
Súvisiace prevádzkové cesty
- Druhý kanál v peňaženke: odovzdanie výdavkov
- idempotencia, opakovania a peniaze
- Vynucovanie limitov rýchlosti pre multi-tenant účty
Začnite s IOSOR
Otvorte konzolu IOSOR a namapujte úverový systém svojho nájomcu priamo do hlavnej účtovnej knihy predplatenej peňaženky. Zabezpečte, aby všetky požiadavky na vloženie na strane servera prešli cez deterministický kľúč idempotencie pred vytvorením zadržania na hlavnej peňaženke. Konfigurujte svoj koncový bod webhooku na spracovanie prichádzajúcich správ o doručení tak, aby sa otvorené zadržania čisto vyriešili na konečné zaťaženie účtovnej knihy alebo uvoľnenia.
Zhrnutie IOSOR
Integrované rozhranie SaaS môže koncovým používateľom prezentovať vlastné kredity na správy, ale každé skutočné odoslanie sa viaže na jedinú predplatenú účtovnú knihu, ktorú financuje nezávislý dodávateľ softvéru. Opakované pokusy, rozšírenia kanálov a signály stavu používateľa sa musia zosúladiť priamo so zadržaniami v peňaženke namiesto nepodložených abstrakcií používateľského rozhrania.
Presadzujte prísne kľúče idempotencie na strane servera a mapujte každý stav používateľského rozhrania nájomcu na skutočné odpovede účtovnej knihy o doručení. Nevytvárajte nepodložené sekundárne peňaženky ani neumožňujte, aby opakované pokusy používateľského rozhrania nájomcu prebehli bez konkrétnych zadržaní v účtovnej knihe.
Pomohol tento sprievodca?
Súvisiace návody
- Vstávanie API vs. partnerský portál white-label
SaaS produkty, ktoré vkladajú správy, zostávajú v rozhraní ISV. Partnerské portály white-label patria pod sekciu Partner — nemiešajte značku, kľúče a vlastníctvo.
- Keď limit embedded tenanta musí zastaviť odosielanie
Limity fair-share vo vnútri produktu ISV musia natvrdo zastaviť odosielanie pre daného tenanta — nikdy nevracať falošné API 200 delivered.