Sandbox da API Pix: valide a integração inteira antes de operar de verdade
Integração de pagamentos só é boa se foi testada nos casos ruins: pagamento que falha, aviso repetido, cobrança que expira. O sandbox simula tudo isso sem usar dinheiro.
O que dá para simular
Criação de cobrança
Gere cobranças e receba QR Codes de teste.
Pagamento
Simule o pagamento da cobrança e veja o webhook chegar.
Falhas
Simule um Pix que falha (chave de teste falha@sandbox.test) para validar o tratamento de erro e o retorno do valor ao saldo.
Pix de saída
Teste a chamada de pagamento e a chave de idempotência.
Separado da produção
A chave de teste é diferente da chave de produção e não move saldo real. Quando o seu time validar o fluxo, basta trocar a credencial. Veja o passo a passo.
Como começar
Abra sua conta
Cadastre-se pelo site, envie os dados e os documentos pedidos e acompanhe a análise do cadastro.
Cobre pelo painel ou integre pela API
Gere cobranças Pix pelo painel ou conecte seu sistema pela API, começando pela chave de teste (sandbox), que não mexe em dinheiro de verdade.
Receba e acompanhe
Receba o aviso de pagamento por webhook, libere o pedido e confira tudo no extrato e nos relatórios.
Perguntas frequentes
O sandbox usa dinheiro de verdade?
Não. É um ambiente de simulação, separado da produção.
Precisa abrir conta para testar?
A documentação explica como obter a chave de teste. Para operar em produção é preciso ter a conta aprovada.
O comportamento é igual ao da produção?
O sandbox segue o mesmo desenho da API. Teste também o limite de requisições e o tratamento de erro.
Sandbox da API Pix: valide a integração inteira antes de operar de verdade
Integração de pagamentos só é boa se foi testada nos casos ruins: pagamento que falha, aviso repetido, cobrança que expira. O sandbox simula tudo…
Veja também
- Como integrar a API PixGuia prático para integrar uma API Pix: autenticação, criar cobrança, receber webhook, validar assinatura, tratar duplicidade e testar no sandbox.
- Webhook de Pix assinadoReceba aviso de Pix recebido, Pix enviado e Pix que falhou por webhook assinado. Veja como validar a assinatura e tratar avisos repetidos.
- API PixAPI Pix com cobrança dinâmica, pagamento por chave ou QR, webhooks assinados, chave de teste e documentação pública. Integre e comece a receber.
- Idempotência em pagamentosIdempotência impede cobrança e pagamento duplicados quando a requisição é repetida. Entenda o conceito e como aplicar em cobranças e Pix de saída.