O Sandbox — construa e teste sem cobranças reais

Cada loja Kliv começa no Sandbox: um back-end de comércio completo e funcional que usa dinheiro simulado. Checkout, assinaturas, reembolsos, falhas de pagamento — tudo funciona exatamente como para clientes reais, exceto que não há movimentação de dinheiro real e você não precisa de uma conta Stripe para começar.

O Sandbox é o padrão. No momento em que você pede ao Kliv para vender algo, você já está nele. Não há nada para assinar, nada para configurar e nenhum risco de cobrar alguém por engano.

Para que serve o Sandbox

Ele permite que você construa e teste toda a sua loja antes que um único cliente real chegue:

  • Crie seu catálogo — produtos, preços, planos e páginas de preços.
  • Faça um checkout real — compre seus próprios produtos com cartões de teste e veja o pedido aparecer.
  • Teste assinaturas — inicie um plano, troque de plano, cancele e veja como a cobrança reage.
  • Veja pagamentos com falha processados — acione um cartão recusado e observe Kliv tentar novamente e enviar um e-mail ao cliente (isso é recuperação de pagamentos).
  • Emitir reembolsos — execute o fluxo de reembolso e aprovação de ponta a ponta.

Como o Sandbox se comporta como o real, tudo o que funciona aqui funcionará da mesma maneira quando você entrar no ar. Você não está testando uma versão de brinquedo — você está testando sua loja real.

Cartões de teste

No Sandbox você paga com números de cartão de teste em vez de cartão real. Cada um é reconhecido como falso e produz um resultado específico, para que você possa ensaiar cada caso — uma venda limpa, uma recusa, uma etapa extra de verificação. Um cartão real nunca funciona no Sandbox (apenas esses números são aceitos), e esses números de teste nunca cobram de ninguém quando você estiver em produção. Os mesmos números também funcionam no modo de teste Stripe depois de conectar o Stripe.

Para cada cartão de teste, insira qualquer data de validade futura, qualquer código de segurança (3 dígitos ou 4 para American Express) e qualquer código postal.

Pagamentos bem-sucedidos

Número do cartão Bandeira
4242 4242 4242 4242 Visa
4000 0566 5566 5556 Visa (débito)
5555 5555 5555 4444 Mastercard
5200 8282 8282 8210 Mastercard (débito)
3782 822463 10005 American Express
6011 1111 1111 1117 Discover
3566 0020 2036 0505 JCB
3056 9300 0902 0004 Diners Club
6200 0000 0000 0005 UnionPay

Declínios

Use-os para ver como uma falha no pagamento é tratada — incluindo novas tentativas e e-mails de recuperação de pagamentos.

Número do cartão Resultado
4000 0000 0000 0002 Declínio genérico
4000 0000 0000 9995 Fundos insuficientes
4000 0000 0000 9987 Cartão perdido
4000 0000 0000 9979 Cartão roubado
4000 0000 0000 0069 Cartão expirado
4000 0000 0000 0127 Código de segurança incorreto
4000 0000 0000 0119 Erro de processamento

Requer verificação extra (3-D Secure)

Alguns cartões acionam a etapa de confirmação que um banco às vezes solicita, então você também pode testar esse fluxo.

Número do cartão Resultado
4000 0025 0000 3155 Solicita autenticação e, em seguida, é bem-sucedido
4000 0082 6000 3178 Solicita autenticação e depois recusa
4000 0000 3220 0000 Autentica automaticamente e depois consegue

Essa separação entre cartões de teste e cartões verdadeiros é deliberada: enquanto você está testando, é impossível receber dinheiro real acidentalmente.

Ensaiando o futuro, não apenas o presente

O Sandbox testa o que acontece agora — uma compra, um reembolso, uma mudança de plano. Para testar o que acontece ao longo do tempo — uma avaliação que termina na próxima semana, uma assinatura sendo renovada no próximo mês, um cartão falhando na terceira tentativa — você bifurca um Scenario e avança o relógio. Isso é abordado em Scenarios e viagem no tempo.

Onde o Sandbox se encaixa

O Sandbox é um dos três ambientes em que sua loja pode operar. Seus dados Sandbox, seus dados de teste e seus dados de produção são mantidos completamente separados — consulte Ambientes explicados para obter uma visão completa.

Quando estiver pronto para receber pagamentos reais, você conecta o Stripe e entra no ar. Nada do que você construiu no Sandbox é perdido — veja Conectando Stripe e entrando ao vivo.

Resumo

  • O Sandbox é um back-end comercial completo e funcional com dinheiro simulado — o padrão, nenhuma conta Stripe é necessária.
  • Tudo o que funciona aqui funciona da mesma forma ao vivo.
  • Pague com cartões de teste (4242 4242 4242 4242 para sucesso); cartões verdadeiros nunca funcionam aqui.
  • Para testar eventos que se desenrolam ao longo do tempo, bifurque um Scenario.