API di evasione SaaS nel marketplace commerciale Microsoft
Le API di evasione SaaS consentono agli editori, noti anche come fornitori di software indipendenti (ISV), di pubblicare e vendere le applicazioni SaaS in Microsoft AppSource, Azure Marketplace e portale di Azure. Queste API consentono alle applicazioni ISV di partecipare a tutti i canali abilitati per il commercio: direct, partner-led (rivenditore) e led sul campo. L'integrazione con queste API è un requisito per la creazione e la pubblicazione di un'offerta SaaS transazionabile nel Centro per i partner.
Per informazioni sulle API di evasione SaaS, è consigliabile leggere anche gli articoli seguenti:
- Gestione del ciclo di vita della sottoscrizione SaaS
- API di sottoscrizione per l'evasione SaaS v2
- API per le operazioni di evasione SaaS v2
- Implementazione di un webhook nel servizio SaaS
- Domande comuni sulle API di evasione SaaS
Flussi API
Gli ISV devono implementare i flussi API seguenti aggiungendo nel codice del servizio SaaS per mantenere lo stesso stato della sottoscrizione per isv e Microsoft:
- Flusso della pagina di destinazione: Microsoft notifica all'editore che l'offerta SaaS dell'editore è stata acquistata da un cliente nel marketplace.
- Flusso di attivazione: il server di pubblicazione notifica a Microsoft che un account SaaS appena acquistato è stato configurato sul lato dell'editore.
- Flusso di aggiornamento: modifica del piano acquistato o del numero di postazioni acquistate o di entrambi.
- Sospendere e ripristinare il flusso: sospendere l'offerta SaaS acquistata nel caso in cui il metodo di pagamento del cliente non sia più valido. L'offerta sospesa può essere ripristinata quando viene risolto il problema relativo al metodo di pagamento.
- Flussi di webhook: Microsoft notifica all'editore le modifiche alla sottoscrizione SaaS e l'annullamento attivati dal cliente dal lato Microsoft.
Per l'annullamento della sottoscrizione SaaS acquistata, l'integrazione è facoltativa, perché può essere eseguita dal cliente dal lato Microsoft.
L'integrazione corretta con le API di evasione SaaS è fondamentale per assicurarsi che:
- I clienti finali che hanno acquistato l'offerta SaaS dell'editore vengono fatturati correttamente da Microsoft.
- I clienti finali ottengono l'esperienza utente corretta per l'acquisto, la configurazione, l'uso e la gestione delle sottoscrizioni SaaS acquistate nel marketplace.
Queste API consentono alle offerte dell'editore di partecipare a tutti i canali abilitati per il commercio:
- Connessione diretta
- Partner-led (rivenditore, Cloud Solution Provider [CSP])
- Led campo
Nello scenario del rivenditore (CSP), un provider di servizi di configurazione acquista l'offerta SaaS per conto del cliente finale. Si prevede che un cliente usi l'offerta SaaS, ma il provider di servizi di configurazione è l'entità che esegue le attività seguenti:
- Fattura il cliente
- Modifica i piani di sottoscrizione/la quantità di postazioni acquistate
- Annulla le sottoscrizioni
Il server di pubblicazione non è necessario per implementare flussi di chiamate API in modo diverso per questo scenario.
Per altre informazioni, vedere Cloud Solution Provider (CSP).
Avviso
Le API di evasione SaaS versione 1 sono deprecate; Usare invece V2. V1 è attualmente in fase di manutenzione solo per gestire gli editori esistenti e la documentazione per V1 non è più disponibile. Se si ritiene che sia necessario accedervi, è possibile inviare un messaggio di posta elettronica saas-api-v1@microsoft.coma .
Nota
Le API di evasione SaaS sono destinate solo a essere chiamate da un servizio back-end del server di pubblicazione. L'integrazione con le API direttamente dalla pagina Web dell'editore non è supportata. È consigliabile usare solo il flusso di autenticazione da servizio a servizio.
Contenuto correlato
- Se non è già stato fatto, registrare l'applicazione SaaS nel portale di Azure come illustrato in Registrare un'applicazione Microsoft Entra. Successivamente, usare la versione più recente di questa interfaccia per lo sviluppo: API di sottoscrizione di evasione SaaS v2 e API per le operazioni di evasione SaaS v2.
Esercitazioni in video