MIDDAG Account

Portugues

English

Portugues

English

Appearance

Converter uma Proposta em Pedido ​

O cliente aceitou uma proposta. Esta receita cobre o que acontece a seguir: criação do pedido, processamento do pagamento, criação do entitlement e como verificar que toda a cadeia foi concluída.

Pré-requisitos ​

  • Uma proposta existe com status accepted (o cliente a aceitou no portal).
  • A entidade de faturamento e a conta Stripe da Organização estão configuradas.
  • O(s) produto(s) WooCommerce na proposta têm uma Entitlement Class atribuída.

Passos ​

Parte A: Verificar a criação do pedido ​

Passo 1. Vá em MIDDAG Account > Quotes e abra a proposta aceita.

Passo 2. Verifique o campo Linked Order. Quando um cliente aceita uma proposta, o sistema cria automaticamente um pedido WooCommerce a partir dos itens da proposta.

Passo 3. Se o campo Linked Order exibir um número de pedido, clique nele para abrir o pedido WooCommerce. Verifique:

  • Os itens do pedido correspondem aos itens da proposta.
  • O pedido está associado à Organização correta.
  • Os metadados da entidade de faturamento estão definidos (middag_br ou middag_global).

Passo 4. Se nenhum pedido foi criado, verifique MIDDAG Account > Logs para erros durante a conversão de proposta em pedido. Causas comuns:

  • O produto não existe mais ou foi movido para a lixeira.
  • O WooCommerce falhou ao criar o pedido (estoque, permissões ou conflito de plugin).

Para criar o pedido manualmente: vá em WooCommerce > Orders > Add Order, adicione os mesmos itens, vincule-o à proposta via a caixa de metadados do MIDDAG Account e defina a entidade de faturamento correta.

Parte B: Processamento do pagamento ​

Passo 5. Após a criação do pedido, o cliente é redirecionado para a página de pagamento no portal. Os métodos de pagamento disponíveis dependem da entidade de faturamento:

EntidadeMétodos disponíveis
MIDDAG BRCartão de crédito (Stripe), Pix (Banco Inter), Boleto (Banco Inter)
MIDDAG GLOBALCartão de crédito (Stripe)

Passo 6. O cliente conclui o pagamento. A confirmação chega via webhook:

  • Cartão de crédito: Stripe dispara payment_intent.succeeded.
  • Pix: Banco Inter dispara um callback dentro de 30 minutos após a leitura do QR code.
  • Boleto: Banco Inter dispara um callback quando o boleto é pago (até 3 dias úteis).

Passo 7. Para monitorar o status do pagamento, vá em WooCommerce > Orders e verifique o status do pedido:

  • pending -- pagamento ainda não recebido.
  • processing ou completed -- pagamento confirmado.
  • failed -- tentativa de pagamento falhou. O cliente pode tentar novamente.

Parte C: Verificar a criação do entitlement ​

Passo 8. Após a confirmação do pagamento, o sistema provisiona o entitlement automaticamente. Vá em MIDDAG Account > Entitlements.

Passo 9. Pesquise pela Organização ou pelo número do pedido. Um entitlement deve aparecer com:

  • Status: active.
  • Classe correspondente ao(s) produto(s) do pedido.
  • Pedido vinculado apontando para o pedido WooCommerce.

Passo 10. Se a proposta continha produtos de diferentes Entitlement Classes, um entitlement é criado para cada classe distinta.

Parte D: Verificar a cadeia completa ​

Passo 11. Confirme que o status da proposta progrediu pelas transições esperadas:

draft -> sent -> viewed -> accepted -> paid -> fulfilled

Passo 12. Confirme que os recursos derivados existem com base na classe do entitlement. Veja Conceder Acesso Após a Compra, Parte C, para passos detalhados de verificação por classe.

Passo 13. Se estiver usando HubSpot, verifique se o status do deal no HubSpot foi atualizado para refletir a proposta aceita e paga. A sincronização ocorre automaticamente via webhook.

Resultado esperado ​

  • A proposta transitou de accepted passando por paid até fulfilled.
  • Um pedido WooCommerce foi criado e pago.
  • Um entitlement com status active existe, com recursos derivados provisionados.
  • O status do deal no HubSpot está sincronizado (se a integração com HubSpot estiver ativa).
  • O cliente pode ver seu novo entitlement no portal.

Leitura complementar ​