Uma loja virtual só está pronta para lançar quando uma compra completa funciona do começo ao fim, inclusive quando dá errado. Isso significa escolher a variação, calcular o frete, aplicar o cupom, pagar com aprovação e com recusa, e ver o pedido chegar à operação com o status certo. Se a implantação inclui medição, a compra também precisa aparecer uma única vez nas ferramentas de análise.
Este guia é para quem está na reta final da implantação, de qualquer plataforma, e precisa de um critério objetivo para dizer “a loja passou”. Ele cobre o aceite da compra. As possibilidades e restrições do checkout de cada plataforma ficam nos guias específicos, como o de implantação Shopify no Brasil. Se você ainda está contratando o projeto, inclua este roteiro na proposta: o checklist para contratar a criação da loja mostra onde ele entra.
Quais etapas da compra o roteiro precisa cobrir?
O erro mais comum é testar só o botão de pagar. A compra começa antes, na página de produto, e termina depois, no painel e no e-mail do cliente. Um roteiro útil percorre cinco etapas, e cada uma tem um jeito próprio de falhar.
| Etapa | O que conferir | Falha típica |
|---|---|---|
| Variação | O tamanho, a cor ou o volume escolhido chega ao carrinho com o preço e o SKU certos | Variação sem estoque aparece como disponível; foto não muda com a cor |
| Frete | O valor e o prazo calculados correspondem à regra combinada para aquele CEP | Opção de entrega some em certos CEPs; frete grátis não respeita o valor mínimo |
| Cupom | O desconto aplica nas condições previstas e é recusado fora delas | Cupom acumula com promoção quando não deveria; vale para produto excluído |
| Pagamento | Cada meio contratado conclui, recusa ou fica pendente como esperado | Pix ou boleto gera pedido como pago antes da compensação |
| Confirmação | O pedido aparece no painel, o cliente recebe a mensagem e a operação é avisada | E-mail com dados errados; pedido duplicado; ERP sem o pedido |
O frete merece um roteiro próprio, porque depende de cadastro de peso e medidas, regiões e integradores. As regras e testes do frete estão em um guia separado; aqui o frete entra só como uma etapa da compra.
Como testar aprovação, recusa e mudança de status?
O teste de pagamento precisa simular os caminhos que o cliente real vai encontrar, sem cobrar ninguém e sem usar dados pessoais. Para isso, quase todo meio de pagamento oferece um ambiente de teste.
Dois exemplos documentados, consultados em 20/10/2026:
- Mercado Pago: a documentação do Checkout Pro orienta usar uma conta de teste de comprador e cartões de teste publicados pelo próprio Mercado Pago. O resultado é definido pelo nome do titular digitado no cartão:
APROsimula pagamento aprovado,OTHEsimula recusa por erro geral,FUNDsimula recusa por saldo insuficiente eCONTdeixa o pagamento pendente. Para Pix ou boleto, o teste é considerado correto quando o pagamento fica pendente e a tela explica como concluí-lo. - Shopify: a central de ajuda descreve três formas de fazer pedido de teste: o gateway de teste da Shopify, o modo de teste do Shopify Payments ou um pedido real cancelado e reembolsado em seguida. A página avisa que enquanto um meio de pagamento está em modo de teste os clientes não conseguem fazer pedidos reais, e que o teste com provedor real pode gerar tarifas.
Esse segundo aviso vira um item do roteiro: antes de abrir a loja, alguém precisa conferir que o modo de teste foi desligado e fazer uma compra real de baixo valor, depois cancelada.
O que observar depois do clique em pagar
A tela de “obrigado” não prova que o pedido foi registrado. Para cada cenário, confira três lugares:
- Painel da loja: o pedido existe, com o status correto (pago, pendente ou recusado) e os itens, o frete e o desconto certos.
- Comunicação: o cliente recebeu a mensagem que corresponde ao status. Pedido recusado não pode receber e-mail de “pagamento confirmado”.
- Operação: quem separa o pedido foi avisado, e, se houver ERP ou emissor de nota, o pedido chegou lá. Pedido pendente não deve liberar separação.
Depois, mude o status: aprove um Pix que estava pendente, cancele um pedido pago, faça um reembolso. A loja precisa refletir cada mudança, e o estoque deve voltar quando o pedido for cancelado, se essa for a regra combinada.
E os eventos de compra?
Quando a implantação analítica faz parte do contrato, o aceite inclui a medição. A documentação de comércio eletrônico do Google Analytics 4 descreve a sequência de eventos do checkout: begin_checkout, add_shipping_info, add_payment_info e purchase, além de refund para reembolsos. O transaction_id é indicado como obrigatório na compra e no reembolso.
A deduplicação depende desse identificador. Segundo a ajuda do Google Analytics, compras com o mesmo transaction_id são tratadas como duplicadas, isso vale para fluxos da web e o identificador não pode ser enviado vazio. Na Meta, a documentação explica que um evento do Pixel e um da API de Conversões são considerados o mesmo quando têm o mesmo nome e o mesmo identificador de evento, dentro de 48 horas. O teste prático é recarregar a página de confirmação e conferir que a compra não foi contada de novo.
O que o checkout padrão permite mudar e o que exige revisão técnica?
Cada plataforma decide quanto do checkout pode ser alterado, e essa decisão costuma depender do plano. Na Shopify, por exemplo, a página de extensibilidade do checkout informa que identidade visual e personalizações padrão estão disponíveis a partir do plano Basic, enquanto aplicativos que alteram as etapas de informações, frete e pagamento são exclusivos do Shopify Plus (consultado em 20/10/2026).
Para o roteiro, separe o que vai ser testado em três grupos:
| Tipo de mudança | Exemplos | Como tratar no aceite |
|---|---|---|
| Configuração do painel | Meios de pagamento ativos, parcelas, campos obrigatórios, logo e cores | Testar como cenário comum do roteiro |
| Aplicativo ou extensão | Antifraude, desconto à vista, campo de CNPJ, mensagem personalizada | Testar o cenário com e sem o app ativo; anotar a versão |
| Integração ou código | Checkout de terceiros, meio de pagamento por API, regra de frete própria | Revisão técnica antes do teste e repetição do roteiro completo a cada atualização |
Quanto mais o checkout se afasta do padrão da plataforma, maior o risco de uma atualização quebrar algo. Esse custo de manutenção precisa estar claro antes de pedir a personalização.
Roteiro de testes do checkout
O roteiro abaixo é um modelo documental: os cenários seguem a documentação citada e devem ser adaptados aos meios de pagamento, às regras de frete e às integrações do seu projeto. Rode tudo em ambiente de teste, com produtos de teste ou estoque reservado, e com dados fictícios. Nunca use cartão, CPF ou endereço de cliente real.
| Nº | Cenário | Passos | Resultado esperado | Evidência a guardar |
|---|---|---|---|---|
| 1 | Variação com estoque | Escolher tamanho e cor, adicionar ao carrinho | Carrinho mostra a variação, o preço e o SKU certos | Captura do carrinho |
| 2 | Variação sem estoque | Tentar comprar combinação zerada | Botão bloqueado ou aviso de indisponível | Captura da página de produto |
| 3 | Frete por CEP | Informar um CEP de cada região atendida | Opções, valores e prazos conforme a regra combinada | Captura com o CEP visível |
| 4 | Cupom válido | Aplicar cupom dentro das condições | Desconto correto no total e no pedido | Captura do resumo e do pedido no painel |
| 5 | Cupom inválido | Aplicar cupom vencido ou abaixo do valor mínimo | Mensagem clara e total sem desconto | Captura da mensagem |
| 6 | Cartão aprovado | Pagar com cartão de teste no cenário de aprovação | Pedido “pago”, e-mail de confirmação, aviso à operação | Número do pedido, captura do painel e do e-mail |
| 7 | Cartão recusado | Pagar com cartão de teste no cenário de recusa | Mensagem de recusa, nova tentativa possível, pedido não liberado | Captura da mensagem e do status |
| 8 | Parcelamento | Pagar em parcelas no limite configurado | Valor da parcela e juros conforme a regra | Captura da seleção de parcelas |
| 9 | Pix pendente | Gerar Pix e não pagar | Pedido “pendente”, instruções de pagamento, sem separação | Captura da tela e do status |
| 10 | Pix aprovado | Simular a confirmação do Pix | Status muda para “pago” e a operação é avisada | Registro da mudança de status |
| 11 | Boleto | Gerar boleto e deixar vencer, se o ambiente permitir | Pedido cancelado ou expirado conforme a regra | Registro do status final |
| 12 | Compra interrompida | Fechar a página no meio do pagamento | Nenhum pedido “pago”; carrinho recuperável, se previsto | Captura do painel |
| 13 | Cancelamento | Cancelar um pedido pago | Status “cancelado”, estoque devolvido, cliente avisado | Registro do estoque antes e depois |
| 14 | Reembolso | Reembolsar total ou parcialmente | Valor estornado registrado e cliente avisado | Registro do reembolso |
| 15 | Integração | Concluir pedido com ERP ou emissor ativo | Pedido chega ao sistema com itens, frete e desconto | Número do pedido nos dois sistemas |
| 16 | Medição | Concluir compra e recarregar a confirmação | Um único evento de compra com o transaction_id do pedido |
Captura da ferramenta de depuração |
| 17 | Celular | Repetir os cenários 1, 6 e 9 no celular | Mesmo resultado, sem campo cortado ou botão inacessível | Gravação de tela |
| 18 | Saída do modo de teste | Desligar o ambiente de teste e fazer uma compra real de baixo valor | Pedido real registrado, depois cancelado e reembolsado | Comprovante do estorno |
Um teste só está aprovado quando o resultado esperado foi observado e a evidência foi guardada. Anote data, navegador, plataforma, versão dos aplicativos envolvidos e quem executou. Se um cenário falhar, corrija e rode de novo o cenário e os que dependem dele.
Condições e limites
Os nomes de cenários de teste, os eventos de medição e as regras de personalização citados foram consultados em 20/10/2026 nas documentações oficiais listadas nas fontes e podem mudar. Cada meio de pagamento tem o próprio ambiente de teste, com regras diferentes: confira a documentação do intermediador que você contratou antes de montar o roteiro. Antifraude, análise de crédito e prazos de recebimento são definidos pelo intermediador, não pela loja. A decisão sobre usar uma compra real no fim do teste, e quem paga eventuais tarifas, deve ser combinada entre o lojista e quem implanta.
Próximo passo
Complete o aceite com as regras e testes do frete, que tratam dos CEPs, dos carrinhos mistos e da falha do cálculo. Se você quer que o roteiro de testes faça parte da entrega, com evidências registradas antes do lançamento, conheça a criação de loja virtual profissional da SouLoja.
