APIs de atendimento SaaS no mercado comercial da Microsoft
As APIs de Atendimento SaaS permitem que os editores, também conhecidos como ISVs (fornecedores independentes de software), publiquem e vendam seus aplicativos SaaS no Microsoft AppSource, no Azure Marketplace e no portal do Azure. Essas APIs permitem que os aplicativos ISV participem de todos os canais habilitados para comércio: direto, liderado por parceiros (revendedor) e liderado por campo. A integração com essas APIs é um requisito para criar e publicar uma oferta de SaaS transacionável no Partner Center.
Para saber mais sobre as APIs de atendimento SaaS, recomendamos que você leia também os seguintes artigos:
- Gerenciando o ciclo de vida da assinatura SaaS
- APIs de assinatura de cumprimento de SaaS v2
- APIs de operações de atendimento SaaS v2
- Implementando um webhook no serviço SaaS
- Perguntas comuns sobre APIs de atendimento SaaS
Fluxos de API
Os ISVs devem implementar os seguintes fluxos de API adicionando em seus códigos de serviço SaaS para manter o mesmo status de assinatura para ISVs e Microsoft:
- Fluxo da página de destino: a Microsoft notifica o editor de que a oferta de 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-comprada foi configurada do lado do editor.
- Fluxo de atualização: alteração do plano adquirido ou do número de assentos comprados ou ambos.
- Suspender e restabelecer o fluxo: suspender a oferta de SaaS comprada caso o método de pagamento do cliente não seja mais válido. A oferta suspensa pode ser restabelecida quando o problema com o método de pagamento for resolvido.
- Fluxos de Webhook: a Microsoft notifica o editor sobre alterações e cancelamentos de assinatura SaaS acionados pelo cliente do 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 APIs de atendimento SaaS é fundamental 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 obtendo a experiência correta do usuário comprando, configurando, usando e gerenciando assinaturas SaaS compradas no mercado.
Essas APIs permitem que as ofertas do editor participem de todos os canais habilitados para comércio:
- Direct
- Liderado por parceiros (revendedor, Cloud Solution Provider [CSP])
- Conduzido em campo
No cenário de 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 executa as seguintes tarefas:
- Fatura o cliente
- Altera planos de subscrição/quantidade de licenças adquiridas
- Cancela as subscrições
O Publisher não é obrigado a implementar nenhum dos fluxos de chamada de API de forma diferente para este cenário.
Para obter mais informações, consulte Provedor de soluções na nuvem (CSP).
Aviso
As APIs de Atendimento SaaS versão 1 foram preteridas; em vez disso, use V2. V1 está sendo mantido apenas para atender editores existentes, e a documentação para 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.
Nota
As APIs de atendimento SaaS destinam-se apenas a ser chamadas a partir de um serviço de back-end do editor. Não há suporte para integração com as APIs diretamente da página da Web do editor. Somente o fluxo de autenticação serviço a serviço deve ser usado.
Conteúdos relacionados
- Se ainda não o fez, registe a sua aplicação SaaS no portal do Azure, conforme explicado em Registar uma Aplicação Microsoft Entra. Depois, use a versão mais atual dessa interface para desenvolvimento: APIs de assinatura de preenchimento SaaS v2 e APIs de operações de atendimento SaaS v2.
Tutoriais de vídeo