Gerenciando o ciclo de vida da assinatura SaaS

  • Artigo

O mercado comercial gerencia todo o ciclo de vida de uma assinatura SaaS após sua compra pelo usuário final. Ele usa a página de destino, as APIs de Fulfillment, as APIs de Operações e o webhook como um mecanismo para impulsionar a ativação, o uso, as atualizações e o cancelamento reais da assinatura SaaS. A fatura do utilizador final baseia-se no estado da subscrição SaaS que a Microsoft mantém.

Estados de uma assinatura SaaS

O diagrama a seguir mostra os estados de uma assinatura SaaS e as ações aplicáveis.

Diagrama mostrando o ciclo de vida do software como uma assinatura de serviço no mercado.

Comprado, mas ainda não ativado (PendingFulfillmentStart)

Depois que um usuário final ou provedor de soluções em nuvem (CSP) compra uma oferta SaaS no mercado comercial, o editor é notificado da compra. O editor pode então criar e configurar uma nova conta SaaS no lado do editor para o usuário final.

Para que a criação da conta aconteça:

  1. O cliente seleciona o botão Configurar conta agora que está disponível para uma oferta SaaS após sua compra bem-sucedida 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 notifica o parceiro sobre a compra abrindo o URL da página de destino com o parâmetro token (o token de identificação de compra do mercado comercial) na nova guia do navegador.

Um exemplo dessa chamada é https://contoso.com/signup?token=<blob>, mas o URL da página de destino para esta oferta de SaaS no Partner Center está configurado como https://contoso.com/signup. Esse token fornece ao editor um ID que identifica exclusivamente a compra de SaaS e o cliente.

Gorjeta

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

Importante

O URL da página de destino deve estar sempre ativo e funcionando o dia todo, todos os dias e pronto para receber novas chamadas da Microsoft. Se a página de destino ficar indisponível, os clientes não poderão se inscrever no serviço SaaS e começar a usá-lo.

Em seguida, o editor deve passar o token de volta para a Microsoft chamando a API SaaS Resolve e inserindo o token como o valor do x-ms-marketplace-token header parâmetro. Como resultado da chamada da API Resolve, o token é trocado por detalhes da compra de SaaS, como o ID exclusivo da compra, o ID da oferta comprada e o ID do plano comprado.

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

Nota

O editor não será notificado da compra de SaaS até que o cliente inicie o processo de configuração do lado da Microsoft.

O editor deve implementar o SSO para fornecer a experiência do usuário exigida pela Microsoft para esse fluxo. Certifique-se de usar o aplicativo multilocatário Microsoft Entra e permitir contas corporativas e de estudante ou contas pessoais da Microsoft ao configurar o SSO. Esse requisito se aplica somente à página de destino, para usuários que são redirecionados para o 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.

Nota

Se o SSO exigir que um administrador conceda permissão a um aplicativo, a descrição da oferta no Partner Center deverá revelar que o acesso em nível de administrador é necessário. Esta divulgação destina-se a cumprir as políticas de certificação do mercado comercial.

Após o login, o cliente deve concluir a configuração de SaaS no lado do editor. Em seguida, o editor deve chamar a API Ativar Assinatura para enviar um sinal ao Azure Marketplace de que o provisionamento da conta SaaS está concluído. Esta ação inicia o ciclo de faturação do cliente. Se a chamada da API Ativar Assinatura não for bem-sucedida, o cliente não será cobrado pela compra.

Diagrama mostrando o A P I chama para um cenário de provisionamento.

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

Nota

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

Ativo (Subscrito)

Ativo (Assinado) é o estado estacionário de uma assinatura SaaS provisionada. Depois que o lado da Microsoft tiver processado a chamada da API Ativar Assinatura, a assinatura SaaS será marcada como Assinada. O cliente agora pode usar o serviço SaaS do lado do editor e é cobrado.

Quando uma assinatura SaaS já estiver ativa, o cliente poderá selecionar Gerenciar experiência 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 destino com o parâmetro token, como acontece no fluxo Ativar. O editor deve distinguir entre novas compras e o gerenciamento de contas SaaS existentes e lidar com essa chamada de URL da página de destino de acordo.

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

A ser atualizado (Subscrito)

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

  • O cliente do mercado comercial.
  • O CSP do mercado comercial.
  • O cliente do site SaaS da editora (mas não para compras feitas pelo CSP).

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

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

Apenas uma subscrição ativa pode ser atualizada. Enquanto a assinatura está sendo atualizada, seu estado permanece ativo no lado da Microsoft.

Atualização iniciada a partir do mercado 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. Depois que uma atualização for inserida, a Microsoft chamará a URL do webhook do editor, configurada no campo Webhook de conexão na página Configuração técnica no Partner Center, com um valor apropriado para ação e outros parâmetros relevantes.
  2. O lado do editor deve fazer as alterações necessárias no serviço SaaS e notificar a Microsoft quando terminar, chamando o Status de Atualização da API de Operação.
  3. Se o patch for enviado com 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.

Nota

O editor deve invocar PATCH para atualizar a API Status da Operação com uma resposta de Falha/Sucesso dentro de uma janela de tempo de 10 segundos após receber a notificação do webhook. Se o PATCH do status da operação não for recebido dentro dos 10 segundos, o plano de alteração será automaticamente corrigido como Êxito.

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

Diagrama mostrando o A P I pede uma atualização iniciada pelo marketplace.

Atualização iniciada a partir do editor

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

  1. Antes de fazer a 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 aplicará a alteração à subscrição e, em seguida, notificará o editor através do webhook Connection para aplicar a mesma alteração.

  3. Só então o editor deve fazer a alteração necessária na assinatura SaaS e notificar a Microsoft quando a alteração for feita chamando Status de Atualização da API de Operação.

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

Diagrama mostrando o A P I pede uma atualização iniciada pelo lado do editor.

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 tanto para o comprador quanto para o proprietário da conta de cobrança.

Suspenso (Suspenso)

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

O editor pode ou não fazer alterações no serviço SaaS no lado do editor. Recomendamos que o editor disponibilize essas informações ao cliente suspenso e limite ou bloqueie o acesso do cliente ao serviço SaaS. Há uma probabilidade de que o pagamento nunca será recebido.

Nota

A Microsoft concede 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 Unsubscribe ação.

Quando uma assinatura está no estado Suspenso :

  • O parceiro ou ISV deve manter a conta SaaS em um estado recuperável, para que a funcionalidade completa possa ser restaurada sem qualquer perda de dados ou configurações.
  • O parceiro ou ISV deve esperar um pedido para restabelecer a subscrição, se o pagamento for recebido durante o período de carência, ou um pedido para anular a subscrição no final do período de carência. Ambos os pedidos serão enviados através do mecanismo webhook.

O estado da assinatura é alterado para Suspenso no lado da Microsoft antes que o editor execute qualquer ação. Apenas as subscrições ativas podem ser suspensas.

Um e-mail de notificação indicando a alteração no status para "suspenso" será enviado tanto para o comprador quanto para o 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.

Reintegrado (Suspenso)

Esta ação indica que o instrumento de pagamento do cliente se tornou válido novamente, que foi efetuado um pagamento pela subscrição SaaS e que a subscrição está a ser restabelecida. Neste caso:

  1. A Microsoft chama webhook com um parâmetro action definido como o valor Reinstate .
  2. O editor certifica-se de que a subscrição está totalmente operacional novamente do lado do editor.
  3. O processo de restabelecimento é bem-sucedido e o cliente é cobrado novamente pela assinatura SaaS.

Apenas uma subscrição suspensa pode ser restabelecida. A assinatura SaaS suspensa permanece em um estado Suspenso enquanto está sendo restabelecida. Após a conclusão desta operação, o estado da subscrição tornar-se-á Ativo.

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

Renovado (Subscrito)

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

Apenas as subscrições ativas são renovadas automaticamente. As subscrições permanecem ativas durante o processo de renovação e se a renovação automática for bem-sucedida. Após a renovação, as datas de início e fim do prazo de subscrição são atualizadas para as datas do novo prazo.

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

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

Cancelado (Não subscrito)

As assinaturas atingem esse estado em resposta a uma ação explícita do cliente ou CSP pelo cancelamento de uma assinatura do site do editor, do portal do Azure ou do Centro de Administração do Microsoft 365. Uma subscrição também pode ser cancelada implicitamente, como resultado do não pagamento de quotas, depois de estar no estado Suspenso durante 30 dias.

Depois que o editor receber uma chamada de webhook de cancelamento, ele deve reter os dados do cliente para recuperação mediante solicitação por pelo menos sete dias. Só então os dados dos clientes podem ser apagados.

Uma assinatura SaaS pode ser cancelada a qualquer momento em seu ciclo de vida. Depois que uma assinatura é cancelada, ela não pode ser reativada.

O e-mail de cancelamento será enviado tanto para o comprador como para o proprietário da conta de faturação.

Próximos passos

Tutoriais de vídeo