> ## Documentation Index
> Fetch the complete documentation index at: https://docs.z2pay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sandbox: visão geral

> Como funciona o ambiente de testes da Z2Pay e por que ele é determinístico.

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.

<CardGroup cols={2}>
  <Card title="Cartões de teste" icon="credit-card" href="/pt-BR/sandbox/cartoes">
    Quais números passam, quais falham — e um gerador de cartão válido.
  </Card>

  <Card title="Documentos de teste" icon="id-card" href="/pt-BR/sandbox/documentos">
    CPFs/CNPJs que aprovam ou recusam um recebedor — e um gerador de documento válido.
  </Card>

  <Card title="PIX e boleto" icon="qr-code" href="/pt-BR/sandbox/pix-boleto">
    Controle a liquidação: pagar na hora, após X minutos ou manualmente.
  </Card>

  <Card title="Simular eventos" icon="wand-sparkles" href="/pt-BR/sandbox/simular">
    Force pagamento manual e chargeback pelo painel.
  </Card>

  <Card title="Roteiro de teste" icon="list-checks" href="/pt-BR/sandbox/roteiro">
    Um passo a passo cobrindo aprovação, recusa, PIX, estorno e chargeback.
  </Card>
</CardGroup>

## 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ço            | URL base                           |
| ------------------ | ---------------------------------- |
| API                | `https://api.sandbox.z2pay.com/v1` |
| Páginas hospedadas | `https://pay.sandbox.z2pay.com`    |

Veja detalhes em [Ambientes](/pt-BR/ambientes).

## Princípio: tudo é determinístico

Diferente de um gateway real (onde o resultado depende do emissor), no sandbox **você controla o
desfecho**:

| Método              | Como o desfecho é decidido                                                                                                      |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Cartão**          | Pelos **últimos 4 dígitos** do número. Ex.: `...1002` = recusado, `...0000` = aprovado.                                         |
| **Recebedor (KYC)** | Pelos **últimos 4 dígitos** do CPF/CNPJ. Ex.: `...0003` = KYC reprovado. Veja [Documentos de teste](/pt-BR/sandbox/documentos). |
| **PIX / boleto**    | Pela **configuração de liquidação** por método (`instant`/`auto`/`manual`) e, opcionalmente, por **valor** (centavos mágicos).  |
| **Chargeback**      | Por **valor** (cartão pago terminando em `31`) ou manualmente pelo painel.                                                      |

<Warning>
  No sandbox o **CVV é ignorado** para cartões — o que importa é o last-4. Em produção, o CVV é
  validado normalmente pela adquirente.
</Warning>

<Tip>
  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.
</Tip>