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 4242para sucesso); cartões verdadeiros nunca funcionam aqui. - Para testar eventos que se desenrolam ao longo do tempo, bifurque um Scenario.