Compartilhar via


APIs de cumprimento de SaaS no marketplace comercial da Microsoft

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.

Tutoriais em vídeo