MIDDAG Account

Portugues

English

Portugues

English

Appearance

Execute seu Primeiro Ciclo de Vida ​

Este é o passo a passo que prova que tudo funciona. Ao final, você terá visto o ciclo de vida completo de um relacionamento com cliente B2B — de um produto WooCommerce a um entitlement criado automaticamente, passando por renovação e chegando à suspensão. Se você completar esta página, você entende como o MIDDAG Account funciona.

O que você vai precisar ​

  • Plugin MIDDAG Account instalado e ativado
  • WooCommerce instalado e configurado com pelo menos um gateway de pagamento (Stripe em modo de teste é recomendado)
  • Pelo menos uma Organização verificada com um colaborador Owner (veja Crie sua Primeira Organização)
  • Familiaridade com criação de produtos no WooCommerce

Fase 1: Crie um produto no WooCommerce ​

Crie um produto no WooCommerce que represente algo que você vende para clientes empresariais.

  1. Vá até WooCommerce > Products > Add New
  2. Dê um nome (ex.: "Pro Plugin — Licença Anual")
  3. Defina um preço (ex.: R$ 499,00)
  4. Se quiser testar assinaturas, use a extensão WooCommerce Subscriptions e defina o período de cobrança para 1 ano
  5. Publique o produto

Este é um produto WooCommerce padrão. Nada de especial até aqui.

Fase 2: Mapeie o produto para uma Entitlement Class ​

É aqui que o MIDDAG Account se conecta ao WooCommerce. Você precisa dizer ao sistema: "Quando alguém comprar este produto, que tipo de entitlement deve ser criado?"

  1. Edite o produto no WooCommerce
  2. Procure a aba MIDDAG Account no painel de dados do produto
  3. Defina a Entitlement Class de acordo com o que este produto concede:
    • Um plugin de software? Selecione Plugin (PLG)
    • Um ambiente de hospedagem gerenciada? Selecione Environment (ENV)
    • Um serviço de consultoria? Selecione Service (SVC)
    • Outra coisa? Selecione Order (ORD) como opção genérica
  4. Atualize o produto

TIP

Você também pode configurar sobrescritas de Policy no nível do produto — por exemplo, definir um período de carência ou janela de renovação específicos para este produto. Para este passo a passo, as policies padrão são suficientes.

Fase 3: Faça um pedido de teste ​

Agora simule uma compra de cliente. Você tem duas opções:

Opção A: Crie o pedido pelo admin do WordPress ​

  1. Vá até WooCommerce > Orders > Add New
  2. Selecione o endereço de cobrança da Organização (ou adicione manualmente)
  3. Clique em Add item(s) e adicione seu produto
  4. Defina o método de pagamento e marque o pedido como Processing ou Completed

Opção B: Faça o pedido pela loja ​

  1. Faça login como o Owner da Organização (ou use uma conta de cliente de teste)
  2. Adicione o produto ao carrinho
  3. Finalize o checkout usando seu gateway de teste (ex.: cartão de teste Stripe 4242 4242 4242 4242)
  4. Confirme que o pedido foi concluído com sucesso

De qualquer forma, você precisa de um pedido pago e concluído vinculado à sua Organização de teste.

Fase 4: Verifique se o entitlement foi criado ​

Este é o momento da verdade. Quando o pagamento é confirmado, o MIDDAG Account deve automaticamente:

  1. Detectar os itens do pedido
  2. Consultar a Entitlement Class mapeada para cada produto
  3. Criar um Entitlement com a classe, código e datas corretos
  4. Vincular o entitlement à Organização e ao Pedido

Confira:

  1. Navegue até MIDDAG Account > Entitlements
  2. Você deve ver um novo entitlement com:
    • Um código como PLG-2026050001 (correspondente à classe selecionada)
    • Status: Active
    • Organização: sua Organização de teste
    • Data de início: hoje
    • Data de expiração: baseada no período de assinatura do produto (ou vazia para compras avulsas)
  3. Clique no entitlement para ver a visualização detalhada. O Pedido vinculado deve aparecer nos registros relacionados.

Se o entitlement não aparecer, verifique:

  • O status do pedido é Completed (ou Processing com pagamento confirmado)?
  • Você mapeou o produto para uma Entitlement Class na Fase 2?
  • A Organização está verificada?

Fase 5: Confira os recursos derivados ​

Dependendo da Entitlement Class, o sistema pode ter provisionado automaticamente recursos adicionais:

Entitlement ClassO que verificar
Plugin (PLG)Um registro de Licença deve existir, vinculado a este entitlement. Confira em MIDDAG Account > Licenses.
Environment (ENV)Um registro de Ambiente deve ter sido criado ou enfileirado para provisionamento. Confira em MIDDAG Account > Environments.
Service (SVC)Um registro de Contrato pode ter sido criado. Confira em MIDDAG Account > Contracts.
Order (ORD)Sem recursos derivados automáticos — ORD é uma opção genérica.

Este provisionamento automático é o que torna o MIDDAG Account mais do que um sistema de rastreamento. O entitlement não apenas registra que o cliente comprou algo — ele dispara a criação de tudo aquilo que a compra concede acesso.

Fase 6: Simule a renovação ​

Agora teste o que acontece quando o entitlement se aproxima da expiração e o cliente renova.

  1. Vá até a tela de detalhes do entitlement
  2. Observe a Expiration Date (se você configurou uma assinatura anual, deve ser um ano a partir de hoje)
  3. Para fins de teste, você pode editar a data de expiração para uma data no passado recente — isso simula um entitlement expirando
  4. Quando um entitlement expira, seu status muda de Active para Expired

Para simular a renovação:

  1. Faça outro pedido do mesmo produto, para a mesma Organização
  2. Quando o pagamento for confirmado, o sistema deve:
    • Detectar o entitlement existente para este produto e Organização
    • Estender a data de expiração (em vez de criar um duplicado)
    • Retornar o status para Active
  3. Verifique se o entitlement mostra a nova data de expiração e status Active

INFO

O comportamento de renovação é controlado pela Renewal Policy. As configurações padrão atendem a maioria dos casos, mas você pode personalizar o período de carência, comportamento de renovação automática e preço de renovação em vários níveis: globalmente, por entitlement class, por produto, por organização ou por entitlement individual.

Fase 7: Simule a suspensão ​

Por último, teste o que acontece quando um pagamento falha ou um admin precisa pausar o acesso.

Suspensão manual (ação do admin) ​

  1. Vá até a tela de detalhes do entitlement
  2. Altere o status de Active para Suspended
  3. Adicione um motivo (ex.: "Testando fluxo de suspensão")
  4. Salve

O que deve acontecer:

  • O status do entitlement muda para Suspended
  • Todos os recursos derivados refletem a suspensão (ex.: a Licença vinculada fica inativa)
  • Se o cliente fizer login no portal, verá o entitlement como suspenso

Reativação ​

  1. Altere o status de volta para Active
  2. Salve

O entitlement e seus recursos derivados devem voltar à operação normal.

Como a suspensão funciona em produção ​

Em um cenário real, a suspensão é normalmente disparada por uma falha de pagamento:

  1. O Stripe reporta uma falha de pagamento via webhook
  2. O MIDDAG Account recebe o webhook e identifica o entitlement afetado
  3. A Payment Recovery Policy determina quanto tempo esperar antes de suspender
  4. Se o período de carência passar sem pagamento bem-sucedido, o entitlement é suspenso automaticamente
  5. Se o pagamento for recuperado (cliente atualiza o cartão, nova tentativa é bem-sucedida), o entitlement reativa automaticamente
  6. Se o período de suspensão expirar sem recuperação, o entitlement passa para Cancelled

Você não precisa testar o fluxo de webhook agora. A suspensão manual acima confirma que as transições de estado e os efeitos nos recursos derivados funcionam corretamente.

O que você comprovou ​

Se completou todas as sete fases, você verificou que:

  • Produtos WooCommerce podem ser mapeados para Entitlement Classes
  • Pedidos criam Entitlements automaticamente com a classe e o código corretos
  • Recursos derivados (licenças, contratos, ambientes) são provisionados automaticamente
  • O ciclo de vida do entitlement (active, expired, suspended, cancelled) funciona como esperado
  • A renovação estende entitlements existentes em vez de criar duplicados
  • A suspensão pausa o acesso no entitlement e em todos os recursos conectados

Este é o modelo operacional central do MIDDAG Account. Todo o restante — orçamentos, faturas, notas fiscais, solicitações de serviço, integrações — é construído sobre esta base.

Próximos passos ​