Conceder Acesso Após a Compra
Um cliente comprou um produto. Esta receita mostra como verificar se o entitlement foi criado automaticamente, solucionar problemas caso não tenha sido e confirmar que os recursos derivados (licença, serviço, ambiente) estão em vigor.
Pré-requisitos
- Acesso de admin ao WordPress.
- Um pedido WooCommerce existe com status
completedouprocessingpara o cliente. - A Organização do cliente existe no MIDDAG Account.
Passos
Parte A: Verificar se o entitlement foi criado
Passo 1. Vá em MIDDAG Account > Entitlements na barra lateral do admin.
Passo 2. Pesquise pelo nome da Organização ou pelo número do pedido.
Passo 3. Se um entitlement aparecer vinculado ao pedido, abra-o e verifique:
- Status é
active. - Class corresponde ao tipo do produto (PLG, ENV, SVC, ORD, AFL ou EDU).
- Entitlement code segue o formato
{CLASS}-{YYYYMM}{SEQ}(ex.:PLG-2026050012). - Linked Order aponta para o pedido WooCommerce correto.
Passo 4. Se o entitlement existe e está active, pule para a Parte C para verificar os recursos derivados.
Parte B: Solucionar problemas se o entitlement não foi criado
Passo 5. Se nenhum entitlement existe para o pedido, verifique o seguinte na ordem:
Mapeamento do produto: Vá em WooCommerce > Products, abra o produto e verifique se uma Entitlement Class está atribuída na aba MIDDAG Account. Se estiver em branco, selecione a classe correta e salve.
Status do pedido: Vá em WooCommerce > Orders e verifique o status do pedido. O pipeline de entitlement é acionado nos status
completedouprocessing. Se o pedido ainda estiverpendingouon-hold, o pagamento ainda não foi confirmado.Webhook do Stripe: Vá ao dashboard do Stripe > Developers > Webhooks e verifique os eventos recentes. Procure por eventos
payment_intent.succeededouinvoice.paid. Verifique se retornaram HTTP 200. Se mostrarem erros, confira se a URL do webhook está correta (/webhooks/stripe/brou/webhooks/stripe/llc).Webhook do Banco Inter: Para pagamentos via Pix/Boleto, verifique MIDDAG Account > Logs para entradas de callback do Banco Inter. O callback de confirmação de pagamento deve ter chegado.
Logs do plugin: Vá em MIDDAG Account > Logs e filtre pelo número do pedido ou Organização. Procure por erros durante o pipeline de provisionamento.
Passo 6. Após resolver o problema, você pode criar o entitlement manualmente:
- Vá em MIDDAG Account > Entitlements e clique em New Entitlement.
- Selecione a Organização.
- Selecione a Entitlement Class correspondente ao produto.
- Vincule o pedido WooCommerce.
- Defina as datas de início e fim.
- Clique em Save. O sistema provisiona os recursos derivados automaticamente.
Parte C: Verificar os recursos derivados
Passo 7. Com base na classe do entitlement, verifique se os recursos corretos foram criados:
Para PLG (Licença de Software):
- Vá à página de detalhes do entitlement e verifique a seção License.
- Verifique se uma chave de licença foi gerada.
- Verifique se o número máximo de ativações por site corresponde à configuração do produto.
- Confirme se o cliente consegue ver a licença no portal em My Products.
Para ENV (Ambiente Gerenciado):
- Verifique a seção Environment na página de detalhes do entitlement.
- Verifique se um registro de Ambiente existe com status
provisioning. - O admin deve provisionar a infraestrutura real (servidor, DNS, backups) e preencher os detalhes do ambiente.
Para SVC (Serviço):
- Verifique a seção Service -- um registro de Serviço deve existir.
- Verifique a seção Contract -- se a criação automática de contrato estiver habilitada na ProvisioningPolicy, um contrato deve existir com status
draftouactive. - Verifique a seção Credit Balance -- um registro de CreditBalance deve existir (pode começar zerado).
Para ORD (Compra Geral):
- Verifique a seção Invoice -- uma fatura do Stripe deve estar sincronizada.
- Verifique se o status da fatura é
paid.
Passo 8. Se recursos derivados estiverem faltando, verifique MIDDAG Account > Logs para erros de provisionamento. Causas comuns: configuração do produto ausente, erros na API de integração ou falhas na entrega de webhooks.
Resultado esperado
- Um entitlement com status
activeexiste, vinculado à Organização e ao pedido do cliente. - Recursos derivados apropriados à classe do entitlement estão criados e acessíveis.
- O cliente pode ver seu novo produto ou serviço no portal.
Leitura complementar
- Ativação de Entitlement -- o pipeline de provisionamento automático.
- Entitlement Classes -- o que cada classe provisiona.
- Entitlements -- ciclo de vida e status dos entitlements.