APIs de atendimento de SaaS no marketplace comercial da Microsoft
As APIs de Cumprimento de SaaS permitem que os editores, também conhecidos como ISVs (fornecedores de software independentes), publiquem e vendam seus aplicativos SaaS no Microsoft AppSource, no Azure Marketplace e no portal do Azure. Essas APIs permitem que aplicativos ISV participem de todos os canais habilitados para comércio: diretos, liderados por parceiros (revendedor) e liderados por campo. A integração com essas APIs é um requisito para criar e publicar uma oferta de SaaS transatlável no Partner Center.
Para saber mais sobre as APIs de atendimento de SaaS, recomendamos que você também leia os seguintes artigos:
- Gerenciando o ciclo de vida da assinatura SaaS
- APIs de Assinatura de processamento de SaaS v2
- APIs para operações de atendimento de SaaS v2
- implementando um webhook no serviço SaaS
- perguntas comuns sobre APIs de atendimento de SaaS
Fluxos de API
Os ISVs devem implementar os seguintes fluxos de API, adicionando ao código de seu serviço SaaS para manter o mesmo status de assinatura tanto para os ISVs quanto para a Microsoft:
- Fluxo de 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 publicador notifica a Microsoft de que uma conta SaaS recém-comprada foi configurada no lado do publicador.
- Fluxo de atualização: alteração do plano adquirido ou do número de assentos adquiridos ou de ambos.
- Suspender e restabelecer o fluxo: suspendendo a oferta de SaaS comprada caso a forma de pagamento do cliente não seja mais válida. A oferta suspensa pode ser restabelecida quando o problema com a forma de pagamento é resolvido.
- Fluxos de Webhook: a Microsoft notifica o editor sobre as alterações e cancelamentos de assinaturas de SaaS iniciados pelo cliente no lado da Microsoft.
Para o cancelamento da assinatura saaS comprada, a integração é opcional, pois pode ser feita pelo cliente do lado da Microsoft.
A integração correta com as APIs de realização de SaaS é essencial para garantir que:
- Os clientes finais que compraram a oferta de SaaS do editor são cobrados corretamente pela Microsoft.
- Os clientes finais estão recebendo a experiência correta do usuário comprando, configurando, usando e gerenciando assinaturas SaaS compradas no marketplace.
Essas APIs permitem que as ofertas do editor participem de todos os canais habilitados para comércio:
- Direto
- Conduzido por parceiro (revendedor, Provedor de Soluções na Nuvem [CSP])
- Conduzido pelo campo
No cenário do revendedor (CSP), um CSP está comprando a oferta de SaaS em nome do cliente final. Espera-se que um cliente use a oferta de SaaS, mas o CSP é a entidade que realiza as seguintes tarefas:
- Faturas do cliente
- Altera os planos de assinatura/quantidade de assentos comprados
- Cancela as assinaturas
Não é necessário que o Publicador implemente qualquer um dos fluxos de chamada de API de forma diferente para este cenário.
Para obter mais informações, consulte CSP (Provedor de Soluções na Nuvem).
Importante
As APIs de processamento de SaaS versão 1 foram preteridas; em vez disso, use a V2. Atualmente, 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, poderá enviar um e-mail para saas-api-v1@microsoft.com.
Nota
As APIs de atendimento de SaaS destinam-se apenas a serem chamadas de um serviço de back-end do publicador. Não há suporte para a integração com as APIs diretamente da página da Web do editor. Apenas o fluxo de autenticação serviço a serviço deve ser usado.
Conteúdo relacionado
- Se você ainda não fez isso, registre seu aplicativo SaaS no portal do Azure, conforme explicado em Registrar um aplicativo do Microsoft Entra.
- Depois, use a versão mais atual dessa interface para desenvolvimento: APIs de assinatura de atendimento de SaaS v2 e APIs de operações de processamento de SaaS v2.
tutoriais de vídeo