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:
- Gerenciando o ciclo de vida da assinatura de SaaS
- APIs de Assinatura de cumprimento de SaaS v2
- APIs de Operações de cumprimento de SaaS v2
- Implementando um webhook no serviço SaaS
- Perguntas comuns sobre APIs de atendimento de SaaS
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
- Se você ainda não tiver feito isso, registre seu aplicativo SaaS no portal do Azure, conforme explicado em Registrar um aplicativo do Microsoft Entra. Posteriormente, use a versão mais atual da interface para desenvolvimento: API de Assinatura de cumprimento de SaaS versão 2 e APIs de Operações de cumprimento de SaaS v2.
Tutoriais em vídeo