APIs de cumprimento de SaaS no marketplace comercial da Microsoft

  • Artigo

Com as APIs de cumprimento de SaaS (Software como Serviço), os distribuidores ou ISVs (fornecedores de software independentes) podem publicar e vender aplicativos SaaS no Microsoft AppSource, no Azure Marketplace e no portal do Azure. Elas permitem que aplicativos de ISVs participem de todos os canais habilitados para comércio: direto, orientado por parceiros (revendedor) e orientado por campo. A integração às APIs é obrigatória para criar e publicar ofertas de SaaS transacionáveis no Partner Center.

Para saber mais sobre as APIs de cumprimento de SaaS, recomendamos ler também os seguintes artigos:

Fluxos de API

Os ISVs devem adicionar os fluxos de API abaixo ao código de serviço SaaS deles para manter o mesmo status de assinatura dos ISVs e da Microsoft:

  • Fluxo da página de aterrissagem: a Microsoft notifica o editor de que a oferta de SaaS do editor foi comprada por um cliente no marketplace.
  • Fluxo de ativação: o editor notifica a Microsoft de que uma conta SaaS recém-adquirida foi configurada no lado do editor.
  • Fluxo de atualização: Alteração do plano adquirido ou do número de licenças compradas ou ambos.
  • Suspender e restabelecer o fluxo: suspender a oferta de SaaS adquirida caso a forma de pagamento do cliente não seja mais válida. É possível restabelecer a oferta suspensa depois de resolver o problema com a forma de pagamento.
  • Fluxos de webhook: a Microsoft notifica o editor sobre alterações de assinatura de SaaS e cancelamento disparados pelo cliente do lado da Microsoft.

A integração do cancelamento da assinatura de SaaS adquirida é opcional porque o cliente pode fazer a operação no lado da Microsoft.

A integração correta às APIs de cumprimento de SaaS é essencial para garantir que:

  • Os clientes finais que adquiriram a oferta de SaaS do distribuidor recebam a cobrança correta da Microsoft.
  • Os clientes finais estão obtendo a experiência de usuário correta ao adquirir, configurar, usar e gerenciar assinaturas de SaaS adquiridas no marketplace.

As APIs permitem que as ofertas do distribuidor participem de todos os canais habilitados para comércio:

  • Direto
  • Liderado por parceiros (revendedor, CSP [Provedor de Soluções na Nuvem])
  • Orientado por campo

No cenário de revendedor (CSP), um CSP (provedor de serviços de criptografia) compra a oferta de SaaS em nome do cliente final. Um cliente usará a oferta de SaaS, mas o CSP é a entidade que faz as seguintes tarefas:

  • Cobra do cliente
  • Altera os planos de assinatura/quantidade de estações adquiridas
  • Cancela as assinaturas

O Publicador não é obrigado a implementar nenhum dos fluxos de chamada à API de forma diferente para esse cenário.

Para obter mais informações, consulte CSP (Provedor de Soluções na Nuvem).

Aviso

A versão 1 das APIs de atendimento de SaaS foi preterida; em vez disso, use V2. No momento, a V1 está sendo mantida apenas para atender aos editores existentes, e a documentação da V1 não está mais disponível. Se você achar que precisa acessá-lo, envie um e-mail saas-api-v1@microsoft.compara .

Observação

As chamadas às APIs de cumprimento de SaaS devem ser feitas apenas em um serviço de back-end do distribuidor. Não há suporte para a integração com as APIs diretamente da página da Web do editor. Somente o fluxo de autenticação de serviço a serviço deve ser usado.

Conteúdo relacionado

Tutoriais em vídeo