# Sandbox (/docs/pix-processamento/sandbox)
O sandbox é uma cópia pública da API Pix para desenvolvimento e testes automatizados. Responde em `https://pix.sandbox.payzu.dev` com as mesmas rotas `/v1` de produção: o código que funciona aqui funciona lá trocando só o host.
* **Sem cadastro.** Você informa um e-mail, confirma um código de 6 dígitos e recebe a credencial na hora: [Gerar credencial](/docs/pix-processamento/sandbox/credencial).
* **Sem dado real.** Nenhuma conta, transação ou chave Pix de produção existe no sandbox, e nada criado nele chega à produção. Não use documento, chave ou e-mail de cliente real nos testes.
* **24 horas.** A credencial e tudo que ela criou (transações, webhooks, infrações) somem depois de 24 horas. Não há renovação: gere outra credencial.
O sandbox não substitui a homologação com a sua conta de produção. O pagador é simulado, a liquidação é automática e os valores seguem regras fixas. Ele serve para escrever e testar a integração antes de ter credencial e para manter testes automatizados estáveis.
## Primeira cobrança [#primeira-cobrança]
Com a credencial em `SANDBOX_TOKEN` (veja [Gerar credencial](/docs/pix-processamento/sandbox/credencial)):
```bash
curl -X POST https://pix.sandbox.payzu.dev/v1/pix \
-H "Authorization: Bearer $SANDBOX_TOKEN" \
-H "Content-Type: application/json" \
-d '{"amount":25.00,"clientReference":"pedido-123"}'
```
A cobrança nasce `PENDING`. Dez segundos depois vira `COMPLETED` e o webhook cadastrado recebe `TRANSACTION_COMPLETED` com `X-Callback-Signature`.
```bash
curl "https://pix.sandbox.payzu.dev/v1/pix?clientReference=pedido-123" \
-H "Authorization: Bearer $SANDBOX_TOKEN"
```
Depois dos 10 segundos, a resposta traz `status: "COMPLETED"`, `endToEndId` e `paidAt`. A mesma consulta vale por `id` ou `endToEndId`, como em [`GET /v1/pix`](/docs/pix-processamento/endpoints/pix-operations/get_pix).
## Referência dos endpoints [#referência-dos-endpoints]
A [referência da API](/docs/pix-processamento/endpoints) vale para os dois ambientes: mesma rota, mesmos campos, outro host. As rotas `/sandbox/...` existem só no sandbox e estão descritas nesta seção.