IOSOR Guide

Integrazione dell'API rispetto a un portale partner white-label

I prodotti SaaS che integrano la messaggistica rimangono sulla superficie ISV. I portali partner white-label rimangono sotto Partner: non mescolare brand, chiavi e proprietà delle operazioni.

Quando un prodotto SaaS integra direttamente la messaggistica, gli utenti finali non aprono mai una console IOSOR. Fanno clic su Invia all'interno dell'interfaccia dell'ISV; l'ISV possiede le chiavi API, i webhook e il wallet prepagato. Questo percorso è l'integrazione diretta (embed). Un portale partner white-label funziona in modo diverso: l'amministratore del partner opera sulle interfacce Partner — con un'interfaccia protetta dal punto di vista del brand, isolamento dei tenant e controlli che non rivelano mai i nomi delle infrastrutture sottostanti.

I team spesso sovrappongono i due modelli: includendo screenshot del portale partner in una presentazione ISV, o mostrando messaggi di errore nello stile di IOSOR all'interno dell'applicazione SaaS.

L'integrazione mantiene la messaggistica all'interno del prodotto SaaS

L'architettura integrata assegna le chiavi API, le chiavi di idempotenza e i ricevitori di webhook all'organizzazione di ingegneria dell'ISV. Le azioni dell'utente finale corrispondono a invii lato server gestiti tramite il wallet prepagato dell'ISV.

Il portale partner rimane una superficie white-label separata

I portali partner sono dedicati agli amministratori dei rivenditori che gestiscono sub-tenant, ripartizioni di margine ed esportazioni in marca bianca. Le schermate rispettano i controlli dell'interfaccia Partner: nessun nome di brand sottostante nelle notifiche, negli errori API, nei webhook o nelle colonne dei file CSV.

Proprietà divisa: interfaccia prodotto rispetto all'interfaccia partner

Decisione Integrazione diretta Portale partner
Pubblico dell'interfaccia Utenti finali ISV Amministratori partner
Custodia delle chiavi Segreti dell'ISV Vault operativo
Linguaggio del brand Testi nativi SaaS Testi in marca b.

Rifiutare le demo ibride che mescolano percorsi di brand

Mostrare un pulsante di invio SaaS e uno screenshot del portale partner nella stessa diapositiva crea aspettative errate nell'acquirente relativamente all'interfaccia utilizzata. Se l'acquirente integra codici OTP all'interno della.

Percorsi operativi correlati

Inizia con IOSOR

Configura i ricevitori dei webhook del tuo prodotto nella console all interno del caveau dei segreti ISV, mantenendo le chiavi API rigorosamente sul tuo server di back-end. Applica il filtro della superficie partner prima di concedere l accesso amministrativo ai rivenditori, per evitare perdite di marchi a monte nei payload DLR o nelle esportazioni CSV. Mantieni isolate la schermata del prodotto e quella del partner sia negli ambienti di staging che in produzione.

Sintesi IOSOR

Integrare la messaggistica tramite un API mantiene il traffico degli utenti finali e gli stati interamente all interno dell interfaccia utente del tuo prodotto SaaS, gestiti dalle chiavi lato server del tuo team di ingegneria. Al contempo, i portali partner white-label esistono esclusivamente affinché gli amministratori dei rivenditori gestiscano strutture di subtenant, distribuzioni di tariffe ed esportazioni con marchio isolato, senza esporre i dettagli dell infrastruttura a monte.

Isola le chiavi API, i ricevitori dei webhook e il rendering dello stato all interno della codebase del tuo prodotto principale. Non presentare demo di vendita ibride né mescolare la schermata amministrativa dei partner con i flussi di messaggistica nativi del prodotto, poiché sfumare questi confini genera fughe di marchi e disallinea la governance dei tenant.

Questa guida ti è stata utile?

Guide correlate