Gerenciando o ciclo de vida da assinatura SaaS
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.
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:
- O cliente seleciona o botão Configurar conta agora que está disponível para uma oferta de 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.
- 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.
Dica
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. O editor tem 30 dias para resolver o ativo quando o status for PendingFulfillmentStart. Caso contrário, o ativo é anulado. Como o ciclo de faturamento não foi iniciado e a respetiva compra não é cobrada, o status muda para Não Assinado. O cliente não é cobrado pela compra.
Importante
O URL da página de destino deve estar ativo e funcionando o dia todo, todos os dias e pronto para receber novas chamadas da Microsoft sempre. 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 o SaaS Resolve APIe inserindo o token como o valor do parâmetro x-ms-marketplace-token header. 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.
Observação
O editor não é 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.
Observação
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 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 o
Tanto o comprador quanto o proprietário da conta de cobrança recebem um e-mail solicitando que configurem a conta.
Observação
O Editor tem 30 dias para resolver o ativo quando o status for PendingFulfillmentStart. Caso contrário, o ativo é anulado, uma vez que o ciclo de faturamento não foi iniciado e a respetiva compra não é faturada. O status muda para não inscrito . O cliente não é cobrado pela compra.
Ativo (Subscrito)
Ativo (Assinado) é o estado estacionário de uma assinatura SaaS provisionada. Depois que o lado da Microsoft processa, o Ativar API de Assinatura chamada, a assinatura SaaS é marcada como Assinado. 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
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. As atualizações iniciam-se 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.
- Depois que uma atualização for inserida, a Microsoft chamará a URL do webhook do editor, configurada no campo webhook
Connection na página de configuração técnica no Partner Center, com um valor apropriado para de ação e outros parâmetros relevantes. - 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.
- Se o patch for enviado com falha status, o processo de atualização não será concluído do lado da Microsoft. A assinatura SaaS mantém o plano existente e a quantidade de licenças.
Observação
O editor deve invocar PATCH para atualizar o Status da API de Operação com uma resposta de Falha/Sucesso dentro de uma janela de tempo de 10 segundos após 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 Success.
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.
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.
- Antes que a alteração solicitada seja feita no lado do editor, o código do editor deve chamar a API Change Plan ou a Change Quantity API ou ambas.
- A Microsoft aplica a alteração à subscrição e, em seguida, notifica o editor através webhook Connection para aplicar a mesma alteração.
- 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.
Um e-mail de notificação indicando uma alteração de plano é enviado ao comprador e ao proprietário da conta de cobrança.
Um e-mail de notificação indicando uma alteração na quantidade é enviado para o comprador e 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 notifica o editor sobre essa alteração no status da assinatura SaaS. A notificação é feita por meio de uma chamada para webhook com a ação parâmetro 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 seja recebido.
Observação
A Microsoft concede ao cliente um período de carência de 30 dias antes de cancelar automaticamente a assinatura. Após o término do período de carência de 30 dias, o webhook recebe uma ação Unsubscribe.
Quando uma assinatura está no Suspenso estado:
- 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. O mecanismo webhook envia ambas as solicitações.
O estado da subscrição é alterado para Suspenso do lado da Microsoft antes de o editor tomar qualquer medida. Apenas as subscrições ativas podem ser suspensas.
Um e-mail de notificação indicando a alteração no status para Suspenso é enviado ao comprador e ao proprietário da conta de cobrança.
Após um período de suspensão de 30 dias, um e-mail sobre o cancelamento pós-suspensão é 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 é válido novamente. Foi efetuado um pagamento pela subscrição SaaS e a subscrição é restabelecida. Neste caso:
- A Microsoft chama webhook com uma ação parâmetro definido para o valor Reinstated.
- O editor certifica-se de que a subscrição está totalmente operacional novamente do lado do editor.
- 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
Um e-mail é 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 Microsoft renova automaticamente a subscrição SaaS 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 continuam 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 é 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 subscrição torna-se Suspensa e o editor é notificado.
Os e-mails de lembrete para renovação sã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 depois que uma ação explícita do cliente ou CSP ocorre para cancelar a assinatura. Eles cancelam uma assinatura do site do editor, do portal do Azure ou do Centro de Administração do Microsoft 365. Uma subscrição também é cancelada implicitamente, como resultado do não pagamento de quotas e depois de estar no estado
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 é enviado para o comprador e para o proprietário da conta de cobrança.
Conteúdo relacionado
Tutoriais em vídeo