IOSOR Tieto
Loppukäyttäjän lähetys veloittaa silti yhtä etukäteismaksettua pääkirjaa
Upotettu lähetys veloittaa edelleen ISV:n etukäteen maksettua lompakkoa. Älä luo toista pääkirjaa, jota tuote ei rahoita.
Upotettu viestintä tuntuu loppukäyttäjälle ilmaiselta: he painavat Lähetä SaaS-käyttöliittymässä ja näkevät vihreän merkin. Pinnan alla jokainen onnistunut lähetys osuu silti yhteen etukäteen maksettuun pääkirjaan, jonka omistaa ISV. Toista lompakkoa ei ilmesty vain siksi, että tuotteeseen on upotettu API. Jos ISV ei rahoita varauksia, lähetyksen on epäonnistuttava rehellisellä tuotevirheellä — ei valheellisella toimitustilalla.
Fiktiivinen kirjanpito on virhetila: sovelluksen sisäinen luottomittari, jota IOSOR-lompakko ei tue, SaaS-palautukset pääkirjan palaessa tai uudelleenyritykset ilman idempotenssia, jotka veloittavat kaksi kertaa yhdestä OTP:stä. Upotus piilottaa konsolin; ISV pysyy rahoittavana osapuolena.
Arkkitehtuurilinja: loppukäyttäjän lähetys ≡ ISV:n etukäteisveloitus. Jokainen suunnittelukatselmus alkaa tästä.
Yksi pääkirja, vaikka käyttöliittymä näyttää tuotekrediittejä
Vuokralaisille myydyt viestipaketit ovat ISV:n kaupallinen kerros. Ne on kartoitettava etukäteisvarauksiksi ja veloituksiksi siihen ainoaan IOSOR-lompakkoon, jota ISV rahoittaa. Vuokralaisen saldo, joka ei koskaan täsmää pääkirjariveihin, on tuki-ansapommi. Vie vuokralaisten käyttö viikoittain lompakkorivejä vasten, jotta talous näkee saman kulutuksen kuin tuote.
Varaukset ja idempotenssi sitovat edelleen upotetuilla poluilla
Palvelimen puoleisessa lähetyksessä on käytettävä idempotenssiaavaimia OTP- ja transaktio-SMS-viesteissä. SaaS-käyttöliittymän kaksoisnapsautus ei saa luoda kahta veloitusta yhdestä käyttäjän toiminnasta. Aikakatkaisun jälkeiset uudelleenyritykset seuraavat samaa avainta lopulliseen DLR-tilaan tai kartoitettuun virheeseen asti.
Kartoita tuotevirheet pääkirjan totuuteen
| SaaS UI -signaali | Pääkirjan totuus | Sallittu seuraava vaihe |
|---|---|---|
| Lähetetty / toimitettu | Veloitus + DLR-polku on olemassa | Näytä kuitin ID |
| Jonossa | Varaus auki tai hyväksytty | Kysely tila |
| Epäonnistui / pysäytetty | Varaus hylätty tai estetty | Yritä uudelleen vain uudella toiminnolla |
| Valheellinen onnistuminen | Ei veloitus. |
Kanavien luovutukset pysyvät samassa lompakossa
Jos tuote myöhemmin lisää sähköpostin tai äänen SMS:n rinnalle, kulutus päätyy edelleen samaan pääkirjaan, ellet suorita toisen kanavan luovutusta taloustiimin hyväksynnällä. Upotus ei luo ilmaista sivukanavaa. Lue lompakon viereisyydestä ennen kuin kytket toisen Live-ruudun SaaS-asetuksissa.
Liittyvät toimintapolut
- Toinen kanava lompakossa: kulujen luovutus
- idempotenssi, uudelleenyritys ja raha
- Nopeusrajoitusten valvonta usean vuokralaisen tileillä
Aloita IOSORilla
Avaa IOSOR-konsoli ja yhdistä vuokralaisen hyvitysjärjestelmä suoraan ensisijaiseen ennakkomaksulompakon kirjanpitoon. Varmista, että kaikki palvelinpuolen upotetut pyynnöt välittävät deterministisen idempotenssiavaimen ennen varauksen tekemistä päärahapussiin. Määritä webhook-päätepisteesi käsittelemään saapuvia toimitusraportteja, jotta avoimet varaukset ratkeavat puhtaasti lopullisiksi kirjanpidon veloituksiksi tai vapautuksiksi.
IOSOR-yhteenveto
Upotettu ohjelmistokäyttöliittymä voi esittää mukautettuja viestihyvityksiä loppukäyttäjille, mutta jokainen todellinen lähetys sitoutuu ISV:n rahoittamaan yksittäiseen ennakkomaksulompakkoon. Uudelleenyritysten, kanavalaajennusten ja käyttäjän tilasignaalien on täsmäytyttävä suoraan lompakkovarausten eikä taustattomien käyttöliittymäabstraktioiden kanssa.
Valvo ehdottomasti tiukkoja palvelinpuolen idempotenssiavaimia ja yhdistä jokainen vuokralaisen käyttöliittymän tila todellisiin kirjanpidon DLR-vastauksiin. Älä keksi taustattomia toissijaisia lompakkoja äläkä salli vuokralaisen käyttöliittymän uudelleenyritysten toteutusta ilman konkreettisia lompakkovarauksia.
Oliko tästä oppaasta apua?
Aiheeseen liittyvät oppaat
- Rajapinnan upotus vs. white-label-kumppaniportaali
SaaS-tuotteet, jotka upottavat viestinnän, pysyvät ISV-rajapinnassa. White-label-kumppaniportaalit kuuluvat Kumppani-osioon — älä sekoita brändiä, avaimia ja omistajuutta.
- Kun upotetun vuokralaisen raja vaatii lähetyksen pysäyttämisen
ISV-tuotteen fair-share-rajojen on pysäytettävä kyseisen vuokralaisen lähetys — eikä koskaan palautettava valheellista delivered API 200 -vastausta.