IOSOR Kunnskap
Innbygging av API versus en white-label partnerportal
SaaS-produkter som bygger inn meldinger forblir i ISV-grensesnittet. Partnerportaler hører hjemme under Partner — ikke bland merkevare, nøkler og eierskap.
Når et SaaS-produkt bygger inn meldinger, åpner sluttbrukerne aldri en IOSOR-konsoll. De klikker på Send inne i ISV-brukergrensesnittet; ISV-en eier nøkler, webhooks og den forskuddsbetalte hovedboken. Den stien er innbygging. En white-label partnerportal er annerledes: partneradministratoren jobber under Partner-overflater — merkevaresikkert grensesnitt, leietakerisolering og porter som aldri lekker oppstrømsnavn.
Team blander ofte de to: partnerskjermbilder i et ISV-dekk, eller IOSOR-lignende feilmeldinger inne i SaaS-produktet. Innbygging betyr at produktet ditt er den eneste flaten kunden ser. Partner betyr en merkevarebyggende portal for videreforhandlere — fortsatt white-label og skjermet, men med et helt annet eierskapskart. Velg én flate for uke én.
Innbygging holder meldinger inne i SaaS-produktet
Innbygging plasserer API-nøkler, idempotensnøkler og webhook-mottakere under ISV-ens ingeniørorganisasjon. Sluttbrukerhandlinger kartlegges til server-side utsendelser med ISV-ens forskuddsbetalte lommebok. SaaS-grensesnittet viser produktstøttet status — i kø, sendt, feilet — aldri eksterne merkevarer og aldri en sekundær innlogging for kunden. Dokumenter hvilken mikrotjeneste som har produksjonsnøklene. Roter nøkler etter ISV-ens faste kadens.
Partnerportal forblir en separat white-label-overflate
Partnerportaler betjener videreforhandleradministraterer som administrerer underleietakere, prisandeler og merkevaresikre eksporter. Skjermer følger Partner-overflateporter: ingen oppstrøms merkevare i meldinger, API-feil, webhooks eller CSV-kolonner. Kataloger matcher alltid kilden. Partneradministratoren er ikke ISV-sluttbrukeren. Ikke plasser en partnerportal i en iframe i SaaS-produktet for å se raskere ut.
Delt eierskap: produktvisning vs. partnervisning
| Beslutning | Innbygging (Embed) | Partnerportal |
|---|---|---|
| Hvem ser UI | ISV-sluttbrukere | Partneradministratorer |
| Nøkler ligger i | ISV-hemmeligheter | Driftshvelv som designet |
| Merkevarespråk | SaaS-produkttekst | White-label partnertekst |
| Eier av hovedbok | ISV forskuddsbetalt konto | Samme konto eller isolasjon |
Publiser tabellen i lanseringsticketen..
Avvis hybride demoer som blander merkevarestier
En SaaS-sendeknapp pluss et skjermbilde av partnerportalen på én lysbilde lærer kjøpere å forvente feil grensesnitt. Hvis kjøperen bygger inn OTP i appen sin, demonstrerer du innbygging og holder partnerartikler kun som tilleggsinformasjon.
Relaterte driftsstier
- Partneroverflateport: ingen merkevarelekasje
- webhooks og nøkler ved lansering
- Pakke kommunikasjons-SKU-er til enhetlige katalogtilbud
Start med IOSOR
Konfigurer produktets webhook-mottakere i konsollen under ISV-hemmelighetslageret, og hold API-nøkler strengt på baksiden. Håndhev partnerporten før du gir forhandleradministratorer tilgang, slik at ingen bakenforliggende merkevarelekkasjer når ut til DLR-laster eller CSV-eksporter. Hold produktets grensesnitt og partnerens grensesnitt adskilt i både test- og produksjonsmiljøer.
IOSOR-lærdom
Innbygging av meldinger via et API holder sluttbrukertrafikk og statuser utelukkende i SaaS-produktets brukergrensesnitt, drevet av utviklingsteamets servernøkler. Samtidig finnes hvitmerkede partnerportaler utelukkende for at forhandleradminer skal kunne administrere underleietakere, prisfordelinger og merkevareisolerte eksporter uten å eksponere underliggende infrastrukturdetaljer.
Isoler API-nøkler, webhook-mottakere og statusgjengivelse i primærkoden for produktet. Ikke kjør hybride salgsdemoer eller blande partnerens administrasjonsgrensesnitt med produktets egne meldingsflyter, da dette skaper merkevarelekkasjer og svekker leietakerstyringen.
Var denne guiden nyttig?
Relaterte veiledninger
- Sluttbrukersending belaster fortsatt én forhåndsbetalt hovedbok
Innbygd sending belaster fortsatt ISV-ens forhåndsbetalte wallet. Ikke finn opp en sekundær hovedbok som produktet ikke finansierer.
- Når et innebygd tenant-tak må stoppe utsending
Fair-share-tak i et ISV-produkt må stoppe utsending for den tenanten — aldri returnere en falsk levert API 200 når taket er nådd.