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:

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.

Esercitazioni in video