Skip to main content
O sandbox é um ambiente de testes isolado, idêntico ao de produção no contrato da API, mas que não movimenta dinheiro real. No lugar das adquirentes, ele simula os pagamentos de forma determinística — você escolhe se um pagamento vai ser aprovado, recusado ou ficar pendente.

Cartões de teste

Quais números passam, quais falham — e um gerador de cartão válido.

Documentos de teste

CPFs/CNPJs que aprovam ou recusam um recebedor — e um gerador de documento válido.

PIX e boleto

Controle a liquidação: pagar na hora, após X minutos ou manualmente.

Simular eventos

Force pagamento manual e chargeback pelo painel.

Roteiro de teste

Um passo a passo cobrindo aprovação, recusa, PIX, estorno e chargeback.

​
Como acessar

  1. Faça login no Dashboard de produção e clique em “Ambiente de testes”.
  2. Pegue suas credenciais de sandbox na seção de credenciais.
  3. Aponte sua integração para as URLs de sandbox:
Veja detalhes em Ambientes.

​
Princípio: tudo é determinístico

Diferente de um gateway real (onde o resultado depende do emissor), no sandbox você controla o desfecho:
No sandbox o CVV é ignorado para cartões — o que importa é o last-4. Em produção, o CVV é validado normalmente pela adquirente.
Como os centavos do valor podem disparar cenários de PIX/boleto/chargeback, ao testar cartão use valores “redondos” (terminando em 00) para não acionar um cenário sem querer.