RecursosGuias

Guia de testes em sandbox: simular pagamentos antes de vender

O sandbox existe para partir tudo sem custo. Use-o a sério.

05 de março de 2026 5 min

Guia de testes em sandbox: simular pagamentos antes de vender

O que é e o que não é

O sandbox reproduz o comportamento da plataforma com dinheiro fictício. Serve para validar o seu código e os seus fluxos, não para testar a rede dos operadores nem a experiência real do cliente em ligação fraca.

Cenários a simular

Percorra os casos infelizes com o mesmo cuidado dos felizes.

  • Aprovação normal.
  • Recusa por saldo insuficiente.
  • Cliente que nunca confirma.
  • Valor acima do limite por transacção.
  • Repetição com a mesma chave de idempotência.
  • Reembolso parcial e reembolso acima do valor pago (deve falhar).

Testar webhooks

Aponte o webhook para um endereço acessível durante os testes e verifique três coisas: a assinatura é validada, um evento repetido não duplica a encomenda e um pedido com assinatura errada é recusado. Confirme o histórico de envios no painel.

Critérios para passar a produção

Todos os cenários acima cobertos, nenhum segredo em código de navegador, registos suficientes para investigar um problema e um responsável identificado para responder a incidentes.