Pular para o conteúdo principal
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 usa um provedor simulado (FakeProvider) que decide o resultado de cada pagamento 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.

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:
ServiçoURL base
API (PSP)https://api.sandbox.z2pay.com
Checkout APIhttps://checkout-api.sandbox.z2pay.com
Páginas hospedadashttps://pay.sandbox.z2pay.com
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:
MétodoComo o desfecho é decidido
CartãoPelos últimos 4 dígitos do número. Ex.: ...1002 = recusado, ...1111 = aprovado.
PIX / boletoPela configuração de liquidação por método (instant/auto/manual) e, opcionalmente, por valor (centavos mágicos).
ChargebackPor valor (cartão pago terminando em 31) ou manualmente pelo painel.
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.