Conectar WooCommerce
O MIDDAG Account usa o WooCommerce como motor de comércio. O WooCommerce cuida do que já faz bem — catálogo de produtos, carrinho de compras, checkout e processamento de pagamentos. O MIDDAG Account assume após a compra para gerenciar o ciclo de vida do cliente: entitlements, licenças, contratos, serviços e renovações.
Esta página explica como os dois sistemas funcionam juntos e o que acontece em cada etapa.
O conceito de ponte
Pense no MIDDAG Account e no WooCommerce como duas camadas:
O WooCommerce responde: Quais produtos existem? Como o cliente paga? O pagamento foi bem-sucedido?
O MIDDAG Account responde: Qual organização comprou? A que ela tem direito? Quando expira? Quais recursos foram provisionados?
Nenhum sistema substitui o outro. O WooCommerce continua funcionando exatamente como antes — seus produtos, gateways de pagamento, cupons e configurações fiscais existentes não são afetados. O MIDDAG Account adiciona uma camada de ciclo de vida por cima.
Produtos mapeiam para Entitlement Classes
Cada produto WooCommerce (ou categoria de produto) pode ser mapeado para uma Entitlement Class. Esse mapeamento informa ao MIDDAG Account qual tipo de entitlement criar quando um cliente compra aquele produto.
| Produto WooCommerce | Entitlement Class | O que é criado |
|---|---|---|
| "Licença Pro Plugin" | PLG (Plugin) | Entitlement + Chave de licença + Acesso a download |
| "Hospedagem Gerenciada - Standard" | ENV (Environment) | Entitlement + Instância de ambiente |
| "Plano de Suporte Anual" | SVC (Service) | Entitlement + Contrato de serviço |
| "Workshop de Treinamento" | EDU (Education) | Entitlement + Acesso ao curso |
| "Programa de Parceiros" | AFL (Affiliate) | Entitlement + Rastreamento de afiliado |
| "Pacote de Desenvolvimento Customizado" | ORD (Order) | Entitlement (uso geral) |
Você configura esse mapeamento em MIDDAG Account > Configurações > Registro de Produtos ou durante o assistente da Configuração Inicial.
Como o mapeamento funciona
- Você cria um produto WooCommerce normalmente (nome, preço, descrição, imagens)
- No editor de produto, um novo painel MIDDAG Account aparece
- Selecione a Entitlement Class para este produto
- Opcionalmente configure definições específicas da classe (duração da licença, tier do ambiente, etc.)
- Salve o produto
Quando um cliente compra este produto, o MIDDAG Account lê o mapeamento e cria o entitlement apropriado automaticamente.
Pedidos criam Entitlements
Quando um pedido WooCommerce atinge o status Concluído, o MIDDAG Account processa cada item do pedido:
- Identificar a organização do comprador. A conta WordPress do cliente está vinculada a uma organização. Se nenhuma organização existir, uma pode ser criada automaticamente ou o administrador é notificado.
- Verificar o mapeamento do produto. Cada item do pedido é verificado em busca de um mapeamento de Entitlement Class.
- Criar o entitlement. Um novo entitlement é criado com um código único (ex.:
PLG-2026050001), vinculado à organização, com status definido como Ativo. - Provisionar recursos downstream. Com base na Entitlement Class, o MIDDAG Account cria os recursos downstream apropriados — chaves de licença, instâncias de ambiente, contratos de serviço, etc.
- Registrar o vínculo financeiro. O entitlement é vinculado de volta ao pedido WooCommerce para auditoria e referência.
Todo esse fluxo é automático. Nenhuma intervenção manual é necessária para compras padrão.
O que o administrador vê
Após um pedido ser concluído:
- O dashboard da Organização mostra o novo entitlement com seu código, classe e status
- A página de detalhe do Entitlement exibe um link para o pedido WooCommerce de origem
- A página do pedido WooCommerce mostra uma referência ao entitlement criado
Status do pagamento direciona o ciclo de vida do entitlement
O MIDDAG Account monitora alterações de status dos pedidos WooCommerce e atualiza os entitlements de acordo:
| Evento WooCommerce | Ação no Entitlement |
|---|---|
| Pedido concluído | Entitlement criado com status Ativo |
| Pagamento falhou (renovação de assinatura) | Entitlement move para Suspenso |
| Pagamento recuperado | Entitlement retorna para Ativo |
| Pedido reembolsado | Veja Reembolsos e cancelamentos abaixo |
| Assinatura expirada | Entitlement move para Expirado |
| Assinatura cancelada | Entitlement move para Cancelado |
O momento exato e o comportamento dessas transições são governados pelo Policy Engine. Por exemplo, você pode configurar um período de carência que mantém o entitlement ativo por 14 dias após um pagamento falhar, dando ao cliente tempo para atualizar seu método de pagamento.
O que acontece em caso de reembolso ou cancelamento
Reembolso total
Quando um pedido WooCommerce recebe reembolso total:
- Todos os entitlements vinculados ao pedido são movidos para o status Cancelado
- Recursos downstream são desativados:
- Chaves de licença são revogadas
- Acesso ao ambiente é suspenso
- Contratos de serviço são encerrados
- O dashboard da organização reflete a mudança imediatamente
- Se configurado, uma notificação automática é enviada à organização
Reembolso parcial
Reembolsos parciais não alteram automaticamente o status do entitlement. O administrador pode revisar e ajustar entitlements manualmente, ou configurar comportamento automático através do Policy Engine.
Cancelamento de pedido (antes do pagamento)
Se um pedido WooCommerce é cancelado antes do pagamento ser concluído, nenhum entitlement é criado (já que entitlements só são criados na conclusão do pedido).
Cancelamento voluntário (pelo cliente)
Quando um cliente cancela uma assinatura:
- O entitlement permanece Ativo até o final do período de cobrança atual
- Ao final do período, o entitlement move para Expirado
- Após o período de retenção configurado, move para Cancelado
- Recursos downstream seguem o mesmo cronograma
A Política de Cancelamento controla os períodos de retenção e se um entitlement cancelado pode ser reativado posteriormente (o fluxo de "reconquista").
Renovações
Para produtos baseados em assinatura, o WooCommerce cuida da cobrança recorrente. O MIDDAG Account gerencia o ciclo de vida do entitlement:
- Antes da expiração: A Política de Renovação pode disparar notificações de lembrete para a organização (ex.: 30 dias, 14 dias e 7 dias antes da expiração).
- Pagamento bem-sucedido: A data de expiração do entitlement é estendida. O status permanece Ativo. Nenhum novo código de entitlement é gerado — o mesmo código persiste entre renovações.
- Pagamento falhou: O entitlement entra em um período de carência (configurável via Política de Recuperação de Pagamento). Durante o período de carência, o entitlement permanece Ativo ou move para Suspenso, dependendo da sua configuração.
- Período de carência expira: Se o pagamento não for recuperado, o entitlement move para Expirado e os recursos downstream são desativados.
Pontos importantes para lembrar
- O WooCommerce continua no comando do comércio. Produtos, preços, cupons, impostos, checkout e processamento de pagamentos permanecem no WooCommerce. Não tente gerenciar isso no MIDDAG Account.
- O MIDDAG Account fica no comando do ciclo de vida. Entitlements, organizações, licenças, contratos e serviços são gerenciados no MIDDAG Account. O WooCommerce não precisa saber sobre eles.
- O elo é o mapeamento de produto. A Entitlement Class atribuída a cada produto WooCommerce é a ponte entre os dois sistemas.
- A automação é configurável. Todo comportamento automático (criação de entitlement, suspensão, cancelamento, notificações) pode ser ajustado através do Policy Engine.
- Dados existentes do WooCommerce não são modificados. O MIDDAG Account adiciona metadados a pedidos e produtos, mas não altera dados ou comportamentos existentes do WooCommerce.
Próximos passos
- Configuração Inicial — Complete o Assistente de Configuração incluindo a conexão com WooCommerce
- Criar sua primeira Organização — Configure uma organização de cliente
- Criar seu primeiro Entitlement — Veja o ciclo de vida do entitlement em ação
- Primeiro Ciclo de Vida — Percorra um ciclo completo de compra até renovação