Testando Pagamentos

Teste o fluxo completo de compra antes de ir ao ar. Um toggle de modo de teste integrado está a caminho; por enquanto, use um cartão real com um produto de baixo valor em um preview publicado.

O Proyecta Commerce é atualmente apenas para produção — não há um toggle dentro do builder que alterne entre o modo de teste e o modo ao vivo. O padrão recomendado hoje é publicar seu app, realizar um pagamento real com um produto de baixo valor e se reembolsar imediatamente.

Fluxo de teste recomendado atualmente

1. Crie um produto de teste de $1 (ou menor unidade da moeda) em Dashboard > Commerce
2. Publique seu app no subdomínio *.proyecta.live
3. Abra a URL publicada em uma aba separada do navegador e execute o fluxo completo de checkout com seu próprio cartão
4. Verifique os efeitos colaterais — os handlers de webhook foram executados, o cliente foi criado, as permissões foram concedidas
5. Reembolse a transação pela aba Dashboard > Commerce > Payments

Isso oferece cobertura completa de ponta a ponta do caminho do dinheiro real, que é a única forma de ter 100% de certeza de que sua integração funciona.

Por que não usar o modo de teste do Stripe?

Atualmente, a conexão do Proyecta com o Stripe roda apenas em modo ao vivo. Um toggle de modo de teste que permite apontar o Commerce para o ambiente de teste do Stripe (e usar cartões fictícios como 4242 4242 4242 4242) está no roadmap.

Dicas

• Teste os caminhos de falha — cartões recusados, checkouts abandonados, erros de rede
• Teste os webhooks de ponta a ponta — certifique-se de que o estado da assinatura é atualizado corretamente quando os eventos do Stripe são disparados
• Teste o cancelamento — o fluxo at_billing_period_end é fácil de deixar passar
• Teste os controles de funcionalidades — chame commerce.check() a partir de um fluxo de UI antes de assumir que funciona

Em breve

• Toggle de modo de teste em Dashboard > Commerce — alterne sua conta de pagamento para o modo de teste do Stripe e use cartões fictícios
• Checkout em modo preview — execute o fluxo de checkout dentro do builder sem precisar publicar
• Simulador de eventos de webhook para disparar eventos falsos do Stripe no seu runtime