Credencial de 24 horas, sem cadastro e sem dado real: rode o fluxo completo da API Pix contra as mesmas rotas de produção, trocando só o host.
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.
- 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
Com a credencial em SANDBOX_TOKEN (veja Gerar credencial):
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.
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.
Referência dos endpoints
A referência da API 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.