Gerenciamento do ciclo de vida de assinaturas de SaaS

O marketplace comercial gerencia todo o ciclo de vida da assinatura de SaaS após sua compra pelo usuário final. Ele usa a página de aterrissagem, as APIs de cumprimento, as APIs de operações e o webhook como mecanismo para direcionar a ativação, o uso, as atualizações e o cancelamento da assinatura de SaaS real. A conta do usuário final é baseada no estado da assinatura de SaaS que a Microsoft mantém.

Estados das assinaturas de SaaS

O diagrama a seguir mostra os Estados das assinaturas de SaaS e as ações aplicáveis.

Adquirido, mas ainda não ativado (PendingFulfillmentStart)

Quando o usuário final ou provedor de soluções de nuvem (CSP) compra uma oferta de SaaS no marketplace comercial, o distribuidor deve ser informado da compra. O distribuidor pode criar e configurar uma conta de SaaS no lado dele para o usuário final.

Para a criação da conta:

1. O cliente seleciona o botão Configurar conta agora, que está disponível para a oferta de SaaS após a compra no Microsoft AppSource ou no portal do Azure. Como alternativa, o cliente pode usar o botão Configurar agora no e-mail que receberá logo após a compra.
2. Em seguida, a Microsoft comunica a compra ao parceiro abrindo em uma guia nova do navegador a URL da página de aterrissagem com o parâmetro de token (o token de identificação de compra do marketplace comercial).

Um exemplo de tal chamada é https://contoso.com/signup?token=<blob>, mas a URL da página de aterrissagem da oferta de SaaS no Partner Center é https://contoso.com/signup. Com o token, o distribuidor tem uma ID que identifica exclusivamente a compra de SaaS e o cliente.

Dica

Não inclua o caractere de sinal de sustenido (#) na URL da página de aterrissagem. Caso contrário, os clientes não poderão acessar sua página de aterrissagem.

Importante

A URL da página de aterrissagem deve estar ativa e em execução o dia todo, todos os dias, pronta para receber novas chamadas da Microsoft em todos os momentos. Se a página de aterrissagem ficar não disponível, os clientes não poderão se inscrever no serviço SaaS e começar a usá-lo.

Em seguida, o distribuidor precisa retornar o token à Microsoft. Para isso, ele deve chamar a API de resolução de SaaS e inserir o token como o valor do parâmetro x-ms-marketplace-token header. Como resultado da chamada à API de resolução, o token é trocado por detalhes da compra de SaaS, como a ID exclusiva da compra, a ID da oferta adquirida e a ID do plano.

Na página de destino, o cliente deve estar conectado à conta SaaS nova ou existente por meio do logon único (SSO) do Microsoft Entra.

Observação

O distribuidor apenas recebe o aviso da compra de SaaS depois que o cliente inicia o processo de configuração no lado da Microsoft.

O distribuidor deve implementar o SSO para proporcionar a experiência de usuário exigida pela Microsoft nesse fluxo. Certifique-se de usar o aplicativo Microsoft Entra multilocatário e permitir contas corporativas e de estudante ou contas pessoais da Microsoft ao configurar o SSO. Essa exigência vale apenas para a página de aterrissagem, para os usuários que são redirecionados ao serviço SaaS quando já estão conectados com as credenciais da Microsoft. O SSO não é necessário para todas as entradas no serviço SaaS.

Observação

Se o SSO exigir a permissão de um administrador ao aplicativo, a descrição da oferta no Partner Center deverá declarar que o acesso de nível de administrador é necessário. Essa declaração é para cumprir com as políticas de certificação do marketplace comercial.

Após a entrada, o cliente deve concluir a configuração de SaaS no lado do distribuidor. Em seguida, o distribuidor deve chamar a API ativar assinatura para enviar um sinal ao Azure Marketplace indicando o término do provisionamento da conta de SaaS. Essa ação inicia o ciclo de faturamento do cliente. Se a chamada da API Ativar Assinatura não for bem-sucedida, o cliente não será cobrado pela compra.

Tanto o comprador quanto o proprietário da conta de faturamento recebem um e-mail solicitando que configurem a conta.

Observação

O Publicador tem 30 dias para resolver o ativo quando o status for PendingFulfillmentStart, caso contrário, o ativo será nulo, uma vez que o ciclo de faturamento não foi iniciado e a respectiva compra não é cobrada, o status mudará para Unsubscribed. O cliente não será cobrado pela compra.

Ativo (assinado)

Ativo (assinado) é o estado estacionário de uma assinatura de SaaS provisionada. Depois que o lado da Microsoft processa a chamada à API ativar assinatura, a assinatura de SaaS é marcada como assinada. O cliente agora pode usar o serviço SaaS do lado do editor e é cobrado.

Quando uma assinatura de SaaS já está ativa, o cliente pode selecionar Gerenciar experiência de SaaS no portal do Azure ou no Centro de Administração do Microsoft 365. Essa ação também faz com que a Microsoft chame a URL da página de aterrissagem com o parâmetro de token, como acontece no fluxo de ativação. O distribuidor deve distinguir entre as novas compras e o gerenciamento de contas SaaS antigas e tratar essa chamada de URL da página de aterrissagem adequadamente.

Um e-mail de notificação de ativação é enviado ao comprador e ao proprietário da conta de cobrança.

Sendo atualizado (assinado)

Essa ação significa que uma atualização de uma assinatura SaaS ativa está sendo processada pela Microsoft e pelo distribuidor. Essa atualização pode ser iniciada por:

• O cliente no marketplace comercial.
• O CSP no marketplace comercial.
• O cliente no site de SaaS do distribuidor (mas não para compras feitas pelo CSP).

Dois tipos de atualizações estão disponíveis para uma assinatura de SaaS:

• Atualizar plano, quando o cliente escolhe outro plano para a assinatura.
• Atualize a quantidade quando o cliente alterar o número de licenças compradas para a assinatura.

É possível atualizar apenas as assinaturas ativas. Durante a atualização da assinatura, seu estado permanece ativo no lado da Microsoft.

Atualização iniciada no marketplace comercial

Nesse fluxo, o cliente altera o plano de assinatura ou a quantidade de licenças do portal do Azure ou do Centro de Administração do Microsoft 365.

1. Após a inserção da atualização, a Microsoft chama a URL do webhook do distribuidor, configurada no campo Webhook de conexão na página Configurações técnicas do Partner Center, com um valor apropriado para a ação e outros parâmetros relevantes.
2. O lado do distribuidor deve fazer as alterações necessárias no serviço SaaS e notificar a Microsoft quando terminar chamando a API atualizar status da operação.
3. Se o patch for enviado com o status de falha, o processo de atualização não será concluído no lado da Microsoft. A assinatura SaaS mantém o plano existente e a quantidade de licenças.

Observação

O distribuidor deve invocar PATCH para API atualizar status da operação com uma resposta de falha/êxito até dez segundos depois de receber a notificação de webhook. Se o PATCH do status da operação não for recebido dentro dos 10 segundos, o plano de alteração será corrigido automaticamente como Êxito.

A sequência de chamadas à API para um cenário de atualização iniciado no marketplace comercial é mostrada no diagrama a seguir.

Atualização iniciada pelo distribuidor

Nesse fluxo, o cliente altera o plano de assinatura ou a quantidade de licenças adquiridas do próprio serviço SaaS.

1. Para fazer uma alteração solicitada no lado do editor, o código do editor deve chamar a API do Plano de Alteração ou a API de Quantidade de Alteração ou ambas.
2. A Microsoft aplica a alteração à assinatura e notifica o distribuidor por meio da Conexão do webhook para aplicar a mesma alteração.
3. Somente então o distribuidor faz a alteração necessária na assinatura de SaaS e notifica à Microsoft após fazê-la chamando a API atualizar status de operação.

A sequência de chamadas à API para um cenário de atualização iniciado no lado do distribuidor é mostrada no diagrama a seguir.

Um e-mail de notificação indicando uma alteração de plano será enviado ao comprador e ao proprietário da conta de cobrança.

Um e-mail de notificação indicando uma alteração na quantidade será enviado ao comprador e ao proprietário da conta de cobrança.

Suspenso (suspenso)

Esse estado indica que o pagamento do cliente pelo serviço SaaS não foi recebido. A Microsoft notificará o editor sobre essa alteração ao status da assinatura de SaaS. A notificação é feita por meio de uma chamada para o webhook com o parâmetro ação definido como SUSPENSO.

O distribuidor pode ou não fazer alterações no serviço SaaS no lado do distribuidor. Recomendamos que o distribuidor disponibilize essas informações ao cliente suspenso e limite ou bloqueie o acesso do cliente ao serviço SaaS. Existe a possibilidade de o pagamento nunca ser recebido.

Observação

A Microsoft dá ao cliente um período de carência de 30 dias antes de cancelar automaticamente a assinatura. Após o período de carência de 30 dias, o webhook receberá uma ação Unsubscribe.

Quando a assinatura está no estado suspenso:

• O parceiro ou ISV deve manter a conta de SaaS em um estado recuperável, que permita restaurar a funcionalidade completa sem perda de dados ou configurações.
• O parceiro ou ISV deve esperar uma solicitação para restabelecer a assinatura, caso o pagamento seja recebido durante o período de carência, ou uma solicitação para desprovisionar a assinatura ao final do período de carência. As duas solicitações serão enviadas por meio do mecanismo de webhook.

O estado da assinatura é alterado para suspenso no lado da Microsoft antes de o distribuidor executar qualquer ação. É possível suspender apenas assinaturas ativas.

Um e-mail de notificação indicando a alteração do status para "suspenso" será enviado ao comprador e ao proprietário da conta de cobrança.

Após um período de 30 dias de suspensão, um e-mail sobre o cancelamento pós-suspensão será enviado ao comprador e ao proprietário da conta de cobrança.

Restabelecido (suspenso)

Essa ação indica que o meio de pagamento do cliente se tornou válido novamente, o pagamento da assinatura de SaaS foi feito e a assinatura está sendo restabelecida. Nesse caso:

1. A Microsoft chama o webhook com um parâmetro de ação com o valor restabelecer.
2. O distribuidor garante que a assinatura esteja totalmente operacional novamente no lado dele.
3. O processo de restabelecimento é bem-sucedido, e a assinatura de SaaS é cobrada novamente ao cliente.

É possível restabelecer apenas assinaturas suspensas. A assinatura de SaaS suspensa permanece no estado suspenso durante o restabelecimento. Após a conclusão da operação, o status da assinatura passa a ser ativo.

Um e-mail será enviado ao comprador e ao proprietário do faturamento após a transição do estado suspenso para o estado restabelecido.

Renovado (assinado)

A assinatura de SaaS é renovada automaticamente pela Microsoft no final do período de assinatura de um mês ou um ano. O padrão da configuração de renovação automática é verdadeiro para todas as assinaturas de SaaS. As assinaturas de SaaS ativas são renovadas regularmente. A Microsoft fornece notificações de webhook somente de informação para eventos de renovação. Um cliente pode desativar a renovação automática de uma assinatura de SaaS por meio do Portal de Administração do Microsoft 365. Nesse caso, a assinatura de SaaS será cancelada automaticamente no final do período de cobrança atual. Os clientes também podem cancelar a assinatura de SaaS a qualquer momento.

Somente as assinaturas ativas são renovadas automaticamente. As assinaturas permanecerão ativas durante o processo de renovação e se a renovação automática for realizada com sucesso. Após a renovação, as datas de início e de término do período da assinatura são atualizadas para as datas do novo período.

Se a renovação automática falhar devido a um problema com o pagamento, a assinatura será suspensa, e o distribuidor será notificado.

Os e-mails de lembrete para renovação serão enviados ao comprador e ao proprietário da conta de faturamento, 30 dias antes da data de renovação anual/plurianual.

Cancelado (assinatura cancelada)

As assinaturas atingem esse estado em resposta a uma ação explícita do cliente ou do CSP de cancelar a assinatura no site do distribuidor, no portal do Azure ou no Centro de Administração do Microsoft 365. As assinaturas também podem ser canceladas implicitamente, como resultado de não pagamento de dívidas, depois de estar no estado suspenso por 30 dias.

Depois de receber uma chamada de webhook de cancelamento, o distribuidor deve manter os dados do cliente por pelo menos sete dias para recuperação mediante solicitação. Os dados do cliente podem ser excluídos apenas após esse período.

Uma assinatura de SaaS pode ser cancelada a qualquer momento em seu ciclo de vida. Não é possível reativar a assinatura após o cancelamento.

O e-mail de cancelamento será enviado ao comprador e ao proprietário da conta de faturamento.

Próximas etapas

• APIs de Assinatura de cumprimento de SaaS v2
• APIs de operações de cumprimento de SaaS v2

Tutoriais em vídeo

• Criação de um Portal de Distribuidor de SaaS simples no .NET
• Uso da API de Cumprimento REST da Oferta de SaaS