Módulo 4 · 4.5
Uma encomenda de teste do início ao fim
Módulo 4: IVA, envio e pagamento · Tempo de leitura: 10 minutos
Objetivo de aprendizagem: Depois desta lição, saberá testar por completo uma encomenda em modo de teste, acompanhar e explicar os estados das encomendas, detetar problemas com webhooks e emails e, no fim, arrumar tudo corretamente.
Conceitos-chave: modo de teste, pagamento de teste, cartão de teste, estados das encomendas (Pagamento pendente, Em processamento, Aguarda confirmação de pagamento, Concluída, Cancelada, Falhada, Reembolsada, Rascunho), registo de webhooks, notas da encomenda, emails de encomenda, manter em stock, lista de verificação de testes, limpeza
Porquê um teste completo
Uma loja pode ter um aspeto perfeito e mesmo assim não vender. O carrinho funciona, a finalização da compra funciona, o cliente paga e, depois, a encomenda fica em "Pagamento pendente" porque o webhook não chega (lição 4.4). Ou o email de confirmação vai parar ao spam. Ou falta o IVA sobre o envio. Só dá por isso quando o primeiro cliente telefona. Uma encomenda de teste completa percorre toda a cadeia, da página do produto ao reembolso, antes de um cliente real o fazer. Repita-a após cada alteração importante: outro plugin de pagamento, um novo tema, uma atualização do WooCommerce, uma definição de cache.
Modo de teste no seu fornecedor de pagamentos
Qualquer fornecedor de pagamentos sério tem um modo de teste: a sua loja comunica com um ambiente de teste do fornecedor, não circula dinheiro real e pode escolher se um pagamento é bem-sucedido ou falha. Nos pagamentos com cartão, utilize os cartões de teste que o fornecedor indica na sua documentação, nunca o seu próprio cartão. Com iDEAL | Wero (Países Baixos) e métodos semelhantes, o ambiente de teste mostra normalmente um ecrã de escolha: pago, falhado, cancelado, expirado. Em Portugal, teste da mesma forma os métodos que oferece, como MB WAY, referência Multibanco, cartão ou PayPal.
Ative o modo de teste nas configurações do plugin de pagamento. Se a sua loja já estiver em funcionamento, teste num ambiente de staging (lição 7.3 e lição 8.3 do curso de WordPress), para que clientes reais não paguem por engano em modo de teste. E, no ambiente de staging, desative os emails para clientes, exceto para o seu próprio endereço de teste.
Os estados das encomendas
O WooCommerce conhece estes estados. O que significam na prática:
| Estado | Significado | O que faz |
|---|---|---|
| Rascunho (Draft) | O cliente está a finalizar a compra com os blocos de finalização de compra; ainda não encomendou | Nada; o WooCommerce elimina os rascunhos antigos |
| Pagamento pendente (Pending payment) | Encomenda criada, pagamento ainda não confirmado | Esperar; se continuar assim, verificar o webhook |
| Falhada (Failed) | Pagamento falhado ou recusado | Não enviar nada; por vezes o cliente tenta de novo |
| Em processamento (Processing) | Pago, stock abatido, ainda não enviado | Embalar e enviar |
| Aguarda confirmação de pagamento (On hold) | À espera de algo, por exemplo uma transferência bancária | Verificar se o dinheiro já entrou |
| Concluída (Completed) | Enviada e terminada | Nada mais, exceto em caso de devolução |
| Cancelada (Cancelled) | Cancelada por si, pelo cliente ou automaticamente | O stock é reposto |
| Reembolsada (Refunded) | Totalmente reembolsada | Atualizar a contabilidade (lição 6.5) |
Algumas coisas acontecem automaticamente. Em Pagamento pendente, o WooCommerce reserva o stock; decorrido o número de minutos definido em Manter em stock (lição 3.4), uma encomenda não paga é cancelada. Em Em processamento, o WooCommerce envia ao cliente o email "Encomenda em processamento" e a si o email "Nova encomenda". Em Concluída, o cliente recebe o email "Encomenda concluída". Para produtos que são virtuais e também descarregáveis, o WooCommerce coloca uma encomenda paga diretamente em Concluída, porque não há nada para enviar.
O teste, passo a passo
A Casa de Chá Example, uma loja online em Utrecht (Países Baixos), testa assim, numa janela privada, como convidado:
- Página do produto: o preço com IVA incluído está correto, com o sufixo (lição 4.1)?
- Carrinho: um bule (classe "Frágil") e um pacote de chá (taxa reduzida). O subtotal, os portes e o IVA estão corretos?
- Finalizar compra com uma morada nos Países Baixos e, depois, com uma morada na Bélgica: aparecem os métodos de envio corretos (lição 4.3) e o IVA correto (lição 4.2)?
- Botão de encomenda: tem um texto que menciona a obrigação de pagamento e uma ligação para os termos e condições e para a informação sobre o direito de livre resolução (lição 5.4)? Em Portugal, por exemplo, «encomenda com obrigação de pagamento» ou outra fórmula inequívoca.
- Pagamento bem-sucedido em modo de teste. Veja em WooCommerce > Encomendas: que estado tem e com que rapidez mudou? Abra a encomenda e leia as notas da encomenda à direita: o plugin de pagamento regista aí o que o fornecedor comunicou.
- Pagamento falhado ou cancelado: uma segunda encomenda, agora com um pagamento de teste falhado. Que estado tem? O stock foi reposto?
- Emails: o email para o cliente e o email para si chegaram? Leia-os como um cliente: contêm os seus dados, a informação sobre o direito de livre resolução e o botão (lições 5.3 e 6.1)?
- Reembolso: reembolse a encomenda de teste bem-sucedida a partir do WooCommerce (botão Reembolso na encomenda, lição 6.5). Vê também o reembolso no painel do fornecedor?
- Limpeza: elimine as encomendas de teste e os clientes de teste, ou acrescente-lhes uma nota clara, para que não entrem no seu volume de negócios nem no seu contador OSS.
Se algo correr mal
- O estado fica em "Pagamento pendente": consulte o registo do plugin de pagamento (frequentemente em WooCommerce > Estado > Registos) para ver se o webhook chegou. Não chegou? Verifique se a sua loja está acessível a partir do exterior (sem palavra-passe no staging para o webhook, sem regra de firewall ou de segurança que o bloqueie, sem modo de manutenção).
- Nenhum email: verifique o remetente e se o email está no spam (lição 6.1). Se o email para si chega e o do cliente não, verifique se o email "Em processamento" está ativo em WooCommerce > Configurações > Emails.
- O IVA não está correto: compare a classe de imposto do produto, a tabela de taxas e a morada (lição 4.1).
- Nenhum método de envio: que zona recebe esta morada (lição 4.3)?
Resumo
- Teste toda a cadeia em modo de teste, também após cada alteração importante, de preferência em staging. Em Portugal, inclua os métodos de pagamento que oferece, como MB WAY ou referência Multibanco.
- Conheça os estados: Pagamento pendente, Em processamento, Aguarda confirmação de pagamento, Concluída, Cancelada, Falhada, Reembolsada e Rascunho.
- Uma encomenda que fica em "Pagamento pendente" após um pagamento bem-sucedido aponta quase sempre para o webhook.
- Leia as notas da encomenda e o registo do plugin de pagamento; leia os emails como um cliente.
- Arrume as encomendas de teste, para que não entrem no seu volume de negócios nem nas contagens de IVA.
Questionário
Exercício
Exercício D4.5: Uma encomenda de teste do início ao fim. Siga os nove passos desta lição na sua própria loja ou loja de teste.
Lista de verificação:
- [ ] fornecedor de pagamentos em modo de teste;
- [ ] encomenda de teste feita como convidado;
- [ ] pagamento bem-sucedido;
- [ ] pagamento falhado ou cancelado;
- [ ] estados vistos em WooCommerce > Encomendas;
- [ ] email para o cliente e para o administrador recebidos;
- [ ] encomenda reembolsada em modo de teste;
- [ ] encomendas de teste eliminadas ou marcadas como teste.
Perguntas:
- Que estados tiveram a encomenda bem-sucedida e a encomenda falhada, e por que ordem?
- Quanto tempo demorou até o estado mudar (o webhook)?
- O que constava do email de confirmação e o que faltava?
Depois de "concluído", verá uma resposta de exemplo: a bem-sucedida passou de Pagamento pendente para Em processamento; a falhada passou de Pagamento pendente para Falhada ou Cancelada; um ponto concreto em falta no email, por exemplo a informação sobre o direito de livre resolução (lição 5.4).
Exercício D4.5: Uma encomenda de teste do início ao fim
Este exercício faz você mesmo; ninguém o verifica. Assinale o que já fez e marque o exercício como concluído.
Bem-sucedida: Pagamento pendente, Em processamento. Falhada: Pagamento pendente, Falhada ou Cancelada. Um ponto concreto em falta no email (por exemplo, a informação sobre a livre resolução, lição 5.4).
As suas marcações e notas ficam apenas neste navegador; não as enviamos para lado nenhum. Se tiver sessão iniciada, guardamos em Os meus cursos apenas que concluiu o exercício.
Para saber mais
- Manual DirectAdmin 18.10: Não consigo enviar e-mail
- Curso gratuito de WordPress 8.3: Staging: testar com segurança
- Managing orders (woocommerce.com, inglês): https://woocommerce.com/document/managing-orders/
- WooCommerce refunds (woocommerce.com, inglês): https://woocommerce.com/document/woocommerce-refunds/
