Gestione del ciclo di vita della sottoscrizione SaaS

Il marketplace commerciale gestisce l'intero ciclo di vita di una sottoscrizione SaaS dopo l'acquisto da parte dell'utente finale. Usa la pagina di destinazione, le API di evasione, le API operazioni e il webhook come meccanismo per guidare l'attivazione effettiva della sottoscrizione SaaS, l'utilizzo, gli aggiornamenti e l'annullamento effettivi. La fattura dell'utente finale si basa sullo stato della sottoscrizione SaaS gestita da Microsoft.

Stati di una sottoscrizione SaaS

Il diagramma seguente illustra gli stati di una sottoscrizione SaaS e le azioni applicabili.

Acquistato ma non ancora attivato (PendingFulfillmentStart)

Dopo che un utente finale o un provider di soluzioni cloud (CSP) acquista un'offerta SaaS nel marketplace commerciale, l'editore riceve una notifica dell'acquisto. Il server di pubblicazione può quindi creare e configurare un nuovo account SaaS sul lato editore per l'utente finale.

Per la creazione dell'account:

1. Il cliente seleziona il pulsante Configura account ora disponibile per un'offerta SaaS dopo l'acquisto riuscito in Microsoft AppSource o il portale di Azure. In alternativa, il cliente può usare il pulsante Configura ora nel messaggio di posta elettronica che riceverà poco dopo l'acquisto.
2. Microsoft invia quindi una notifica al partner sull'acquisto aprendo l'URL della pagina di destinazione con il parametro token (token di identificazione dell'acquisto dal marketplace commerciale) nella nuova scheda del browser.

Un esempio di tale chiamata è https://contoso.com/signup?token=<blob>, ma l'URL della pagina di destinazione per questa offerta SaaS nel Centro per i partner è configurato come https://contoso.com/signup. Questo token fornisce all'editore un ID che identifica in modo univoco l'acquisto SaaS e il cliente.

Suggerimento

Non includere il carattere di segno cancelletto (#) nell'URL della pagina di destinazione. In caso contrario, i clienti non potranno accedere alla pagina di destinazione.

Importante

L'URL della pagina di destinazione deve essere attivo e in esecuzione tutto il giorno, ogni giorno e pronto a ricevere nuove chiamate da Microsoft in qualsiasi momento. Se la pagina di destinazione non è più disponibile, i clienti non potranno iscriversi al servizio SaaS e iniziare a usarla.

Il server di pubblicazione deve quindi passare nuovamente il token a Microsoft chiamando l'API resolve SaaS e immettendo il token come valore del x-ms-marketplace-token header parametro. Come risultato della chiamata all'API Resolve, il token viene scambiato per i dettagli dell'acquisto SaaS, ad esempio l'ID univoco dell'acquisto, l'ID dell'offerta acquistata e l'ID del piano acquistato.

Nella pagina di destinazione il cliente deve accedere all'account SaaS nuovo o esistente tramite l'accesso Single Sign-On (SSO) di Microsoft Entra.

Nota

L'editore non riceverà una notifica dell'acquisto SaaS finché il cliente non avvia il processo di configurazione dal lato Microsoft.

Il server di pubblicazione deve implementare l'accesso SSO per fornire l'esperienza utente richiesta da Microsoft per questo flusso. Assicurarsi di usare l'applicazione Microsoft Entra multi-tenant e di consentire sia gli account aziendali che dell'istituto di istruzione o gli account Microsoft personali durante la configurazione dell'accesso SSO. Questo requisito si applica solo alla pagina di destinazione, per gli utenti reindirizzati al servizio SaaS quando hanno già eseguito l'accesso con le credenziali Microsoft. L'accesso Single Sign-On non è necessario per tutti gli accessi al servizio SaaS.

Nota

Se l'accesso Single Sign-On richiede che un amministratore conceda l'autorizzazione a un'app, la descrizione dell'offerta nel Centro per i partner deve divulgare l'accesso a livello di amministratore. Questa divulgazione è conforme ai criteri di certificazione del marketplace commerciale.

Dopo l'accesso, il cliente deve completare la configurazione SaaS sul lato editore. Il server di pubblicazione deve quindi chiamare l'API Attiva sottoscrizione per inviare un segnale ad Azure Marketplace che il provisioning dell'account SaaS è stato completato. Questa azione avvia il ciclo di fatturazione del cliente. Se la chiamata all'API Attiva sottoscrizione non riesce, il cliente non viene fatturato per l'acquisto.

Sia l'acquirente che il proprietario dell'account di fatturazione ricevono un messaggio di posta elettronica che richiede di configurare l'account.

Nota

Il server di pubblicazione ha 30 giorni per risolvere l'asset quando lo stato è PendingFulfillmentStart. In caso contrario, l'asset verrà annullato perché il ciclo di fatturazione non è stato avviato e il rispettivo acquisto non viene fatturato lo stato cambierà in Annulla sottoscrizione. Il cliente non verrà fatturato per l'acquisto.

Attivo (sottoscritto)

Attivo (sottoscritto) è lo stato costante di una sottoscrizione SaaS con provisioning. Dopo che il lato Microsoft ha elaborato la chiamata all'API Attiva sottoscrizione, la sottoscrizione SaaS viene contrassegnata come Sottoscritta. Il cliente può ora usare il servizio SaaS sul lato dell'editore e viene fatturato.

Quando una sottoscrizione SaaS è già attiva, il cliente può selezionare Gestisci esperienza SaaS dal portale di Azure o Amministrazione Microsoft 365 Center. Questa azione fa anche in modo che Microsoft chiami l'URL della pagina di destinazione con il parametro token, come avviene nel flusso Activate. L'editore deve distinguere tra nuovi acquisti e la gestione degli account SaaS esistenti e gestire di conseguenza questa chiamata URL della pagina di destinazione.

Un messaggio di posta elettronica di notifica di attivazione viene inviato sia all'acquirente che al proprietario dell'account di fatturazione.

Aggiornamento (sottoscritto)

Questa azione significa che un aggiornamento a una sottoscrizione SaaS attiva esistente viene elaborato sia da Microsoft che dal server di pubblicazione. Un aggiornamento di questo tipo può essere avviato da:

• Il cliente dal marketplace commerciale.
• Provider di servizi di configurazione dal marketplace commerciale.
• Il cliente dal sito SaaS dell'editore (ma non per gli acquisti effettuati da CSP).

Per una sottoscrizione SaaS sono disponibili due tipi di aggiornamenti:

• Aggiornare il piano quando il cliente sceglie un altro piano per la sottoscrizione.
• Aggiornare la quantità quando il cliente modifica il numero di licenze acquistate per la sottoscrizione.

È possibile aggiornare solo una sottoscrizione attiva. Durante l'aggiornamento della sottoscrizione, lo stato rimane Attivo sul lato Microsoft.

Aggiornamento avviato dal marketplace commerciale

In questo flusso, il cliente modifica il piano di sottoscrizione o la quantità di licenze dal portale di Azure o Amministrazione Microsoft 365 Center.

1. Dopo l'immissione di un aggiornamento, Microsoft chiamerà l'URL del webhook dell'editore, configurato nel campo webhook Connessione ion nella pagina Configurazione tecnica del Centro per i partner, con un valore appropriato per l'azione e altri parametri pertinenti.
2. Il lato server di pubblicazione deve apportare le modifiche necessarie al servizio SaaS e inviare una notifica a Microsoft al termine chiamando l'API Update Status of Operation.
3. Se la patch viene inviata con stato di errore , il processo di aggiornamento non verrà completato sul lato Microsoft. La sottoscrizione SaaS mantiene il piano esistente e la quantità di licenze.

Nota

L'autore deve richiamare PATCH per aggiornare lo stato dell'API operazione con una risposta di errore/esito positivo entro un intervallo di tempo di 10 secondi dopo aver ricevuto la notifica del webhook. Se PATCH dello stato dell'operazione non viene ricevuto entro 10 secondi, il piano di modifica viene automaticamente patchato come Operazione riuscita.

La sequenza di chiamate API per uno scenario di aggiornamento avviato dal marketplace commerciale è illustrato nel diagramma seguente.

Aggiornamento avviato dal server di pubblicazione

In questo flusso, il cliente modifica il piano di sottoscrizione o la quantità di licenze acquistate dal servizio SaaS stesso.

1. Prima di apportare la modifica richiesta sul lato editore, il codice di pubblicazione deve chiamare l'API Change Plan o l'API Change Quantity o entrambi.

2. Microsoft applicherà la modifica alla sottoscrizione e quindi informerà l'editore tramite Connessione webhook per applicare la stessa modifica.

3. Solo allora il server di pubblicazione deve apportare la modifica necessaria alla sottoscrizione SaaS e inviare una notifica a Microsoft quando la modifica viene eseguita chiamando l'API Update Status of Operation.

La sequenza di chiamate API per uno scenario di aggiornamento avviato dal lato editore è illustrato nel diagramma seguente.

Un messaggio di posta elettronica di notifica che indica una modifica del piano verrà inviato sia all'acquirente che al proprietario dell'account di fatturazione.

Un messaggio di posta elettronica di notifica che indica una modifica della quantità verrà inviato sia all'acquirente che al proprietario dell'account di fatturazione.

Sospeso (sospeso)

Questo stato indica che il pagamento di un cliente per il servizio SaaS non è stato ricevuto. Microsoft informerà l'editore di questa modifica nello stato della sottoscrizione SaaS. La notifica viene eseguita tramite una chiamata al webhook con il parametro action impostato su Suspended.

Il server di pubblicazione potrebbe o non apportare modifiche al servizio SaaS sul lato editore. È consigliabile rendere disponibili queste informazioni al cliente sospeso e limitare o bloccare l'accesso del cliente al servizio SaaS. C'è una probabilità che il pagamento non venga mai ricevuto.

Nota

Microsoft offre al cliente un periodo di tolleranza di 30 giorni prima di annullare automaticamente l'abbonamento. Dopo il periodo di tolleranza di 30 giorni, il webhook riceverà un'azione Unsubscribe .

Quando una sottoscrizione si trova nello stato Sospeso :

• Il partner o l'ISV deve mantenere l'account SaaS in uno stato ripristinabile, in modo che la funzionalità completa possa essere ripristinata senza perdita di dati o impostazioni.
• Il partner o l'ISV deve prevedere una richiesta di reintegrare la sottoscrizione, se il pagamento viene ricevuto durante il periodo di tolleranza o una richiesta di deprovisioning della sottoscrizione alla fine del periodo di tolleranza. Entrambe le richieste verranno inviate tramite il meccanismo webhook.

Lo stato della sottoscrizione viene modificato in Sospeso sul lato Microsoft prima che il server di pubblicazione eseleva qualsiasi azione. È possibile sospendere solo le sottoscrizioni attive.

Un messaggio di posta elettronica di notifica che indica la modifica dello stato in "sospeso" verrà inviato sia all'acquirente che al proprietario dell'account di fatturazione.

Dopo un periodo di sospensione di 30 giorni, verrà inviato un messaggio di posta elettronica relativo all'annullamento post-sospensione sia all'acquirente che al proprietario dell'account di fatturazione.

Reinstated (Suspended)

Questa azione indica che lo strumento di pagamento del cliente è di nuovo diventato valido, è stato effettuato un pagamento per la sottoscrizione SaaS e che la sottoscrizione viene ripristinata. In questo caso:

1. Microsoft chiama webhook con un parametro di azione impostato sul valore Reinstate .
2. L'autore verifica che la sottoscrizione sia nuovamente operativa sul lato editore.
3. Il processo di ripristino ha esito positivo e il cliente viene nuovamente fatturato per la sottoscrizione SaaS.

È possibile reinserire solo una sottoscrizione sospesa. La sottoscrizione SaaS sospesa rimane in stato Sospeso mentre viene ripristinata. Al termine dell'operazione, lo stato della sottoscrizione diventerà Attivo.

Un messaggio di posta elettronica verrà inviato sia all'acquirente che al proprietario della fatturazione dopo la transizione dallo stato sospeso allo stato ripristinato.

Rinnovato (sottoscritto)

La sottoscrizione SaaS viene rinnovata automaticamente da Microsoft alla fine del periodo di sottoscrizione di un mese o di un anno. Il valore predefinito per l'impostazione di rinnovo automatico è true per tutte le sottoscrizioni SaaS. Le sottoscrizioni SaaS attive continueranno a essere rinnovate con cadenza regolare. Microsoft fornisce notifiche webhook di sola informazione per il rinnovo degli eventi. Un cliente può disattivare il rinnovo automatico per una sottoscrizione SaaS tramite il portale di Amministrazione Microsoft 365. In questo caso, la sottoscrizione SaaS verrà annullata automaticamente alla fine del periodo di fatturazione corrente. I clienti possono anche annullare la sottoscrizione SaaS in qualsiasi momento.

Vengono rinnovate automaticamente solo le sottoscrizioni attive. Le sottoscrizioni rimangono attive durante il processo di rinnovo e, se il rinnovo automatico ha esito positivo. Dopo il rinnovo, le date di inizio e di fine del periodo di sottoscrizione vengono aggiornate alle date del nuovo termine.

Se un rinnovo automatico non riesce a causa di un problema di pagamento, l'abbonamento verrà sospeso e l'editore riceverà una notifica.

I messaggi di posta elettronica di promemoria per il rinnovo verranno inviati sia all'acquirente che al proprietario dell'account di fatturazione, 30 giorni prima della data di rinnovo annuale/multiyear.

Annullata (annullata)

Le sottoscrizioni raggiungono questo stato in risposta a un'azione esplicita del cliente o CSP dall'annullamento di una sottoscrizione dal sito di pubblicazione, dal portale di Azure o Amministrazione Microsoft 365 Center. Una sottoscrizione può anche essere annullata in modo implicito, in seguito al mancato pagamento delle quote, dopo essere stata sospesa per 30 giorni.

Dopo che l'editore riceve una chiamata webhook di annullamento, deve conservare i dati dei clienti per il ripristino su richiesta per almeno sette giorni. Solo in seguito è possibile eliminare i dati dei clienti.

Una sottoscrizione SaaS può essere annullata in qualsiasi momento del ciclo di vita. Dopo l'annullamento di una sottoscrizione, non può essere riattivata.

L'e-mail di annullamento verrà inviata sia all'acquirente che al proprietario dell'account di fatturazione.

Passaggi successivi

• API di sottoscrizione per l'evasione SaaS v2
• API per le operazioni di evasione SaaS v2

Esercitazioni in video

• Creazione di un portale di pubblicazione SaaS semplice in .NET
• Uso dell'API di evasione REST dell'offerta SaaS