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 destino: a Microsoft notifica o editor de que a oferta SaaS do editor foi comprada por um cliente no mercado.
  • Fluxo de ativação: o Publisher notifica a Microsoft de que uma conta SaaS recém-adquirida foi configurada do lado do editor.
  • Fluxo de atualização: Alteração do plano comprado ou do número de assentos comprados ou ambos.
  • Suspender e restabelecer o fluxo: suspendendo a oferta SaaS comprada caso o método de pagamento do cliente não seja mais válido. É 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 SaaS e cancelamento acionado 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 pelo parceiro (revendedor, provedor de soluções na nuvem [CSP])
  • 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 de API de forma diferente para esse cenário.

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

Aviso

APIs de Atendimento SaaS versão 1 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ê sentir que precisa acessá-lo, você pode enviar um e-mail saas-api-v1@microsoft.com.

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.

Próximas etapas

Tutoriais em vídeo