Condividi tramite

API per le soluzioni SaaS nel marketplace commerciale di Microsoft

  • Articolo

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 nel portale di Azure. Queste API consentono alle applicazioni ISV di partecipare a tutti i canali abilitati per il commercio: direct, guidati dai partner (rivenditori) e guidati dal 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 implementazione SaaS, è consigliabile anche leggere gli articoli seguenti:

Flussi delle API

Gli ISV devono implementare i seguenti flussi API inserendo 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 fornitore notifica a Microsoft che un account SaaS appena acquistato è stato configurato sul lato del fornitore.
  • flusso di aggiornamento: modifica del piano acquistato o del numero di postazioni acquistate o di entrambi.
  • Sospendere e ripristinare il flusso: sospensione dell'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 al publisher le modifiche alla sottoscrizione SaaS e l'annullamento attivati dal cliente tramite la piattaforma 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 garantire 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:

  • Diretto
  • Guidato dai partner (rivenditore, Fornitore di Soluzioni Cloud [CSP])
  • Guidato dal campo

Nel contesto del rivenditore (CSP), un CSP 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 abbonamento e la quantità di posti acquistati
  • Annulla le sottoscrizioni

L'editore non è tenuto a implementare in modo diverso i flussi di chiamate API per questo scenario.

Per altre informazioni, vedere Cloud Solution Provider (CSP).

Importante

Le API di SaaS versione 1 sono deprecate; utilizzare invece la Versione 2. 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.com.

Nota

Le API di adempimento SaaS sono destinate solo a essere chiamate da un servizio back-end del publisher. 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

esercitazioni video