Skip to content

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 completed ou processing para 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:

  1. 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.

  2. Status do pedido: Vá em WooCommerce > Orders e verifique o status do pedido. O pipeline de entitlement é acionado nos status completed ou processing. Se o pedido ainda estiver pending ou on-hold, o pagamento ainda não foi confirmado.

  3. Webhook do Stripe: Vá ao dashboard do Stripe > Developers > Webhooks e verifique os eventos recentes. Procure por eventos payment_intent.succeeded ou invoice.paid. Verifique se retornaram HTTP 200. Se mostrarem erros, confira se a URL do webhook está correta (/webhooks/stripe/br ou /webhooks/stripe/llc).

  4. 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.

  5. 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:

  1. Vá em MIDDAG Account > Entitlements e clique em New Entitlement.
  2. Selecione a Organização.
  3. Selecione a Entitlement Class correspondente ao produto.
  4. Vincule o pedido WooCommerce.
  5. Defina as datas de início e fim.
  6. 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 draft ou active.
  • 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 active existe, 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