Testando Pagamentos

Teste o fluxo completo de compra antes de ir para produção. 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 funciona atualmente apenas em produção — não há um toggle dentro do builder que alterne entre modo de teste e 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 hoje

1. Crie um produto de teste de $1 (ou a menor unidade da moeda) em Admin > 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 o seu próprio cartão
4. Verifique os efeitos colaterais — handlers de webhook executados, cliente criado, permissões concedidas
5. Reembolse a transação na aba Admin > Commerce > Payments

Isso garante cobertura completa de ponta a ponta do fluxo de 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?

Hoje, a conexão do Proyecta com o Stripe opera 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 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 ignorar
• Teste os bloqueios de funcionalidades — acesse a rota bloqueada na interface antes de assumir que funciona

Em breve

• Toggle de modo de teste em Admin > 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 publicar
• Simulador de eventos de webhook para disparar eventos falsos do Stripe no seu runtime