Skip to main content
O sandbox é um ambiente isolado para testar sua integração sem cobranças reais. Tudo funciona exatamente como em produção — incluindo webhooks — mas nenhuma transação é processada de verdade.

​
Chaves de API

Cada projeto tem duas chaves de API:
Nunca use sk_live_* em código frontend, repositórios públicos ou variáveis de ambiente não protegidas.

​
Simulando pagamentos

No sandbox, confirme uma transação sem precisar de um PIX real:
cURL
Após a simulação, o webhook configurado no projeto é disparado automaticamente com o evento transaction.paid.
Webhooks funcionam normalmente no sandbox — ideal para testar o fluxo completo de ponta a ponta.

​
Desfecho automático pelos centavos

No sandbox, o desfecho da cobrança é controlado pelos dois últimos dígitos do valor — sem precisar chamar o endpoint de simulação: Ideal para testes automatizados: crie três cobranças e valide os três fluxos de webhook de uma vez.

​
Identificando transações sandbox

Transações criadas com sk_test_* ficam isoladas das de produção. O campo isSandbox: true é incluído no payload dos webhooks para facilitar a identificação.

​
Próximos passos

Simular pagamento

Force o pagamento de uma cobrança sandbox pela API.

Configurar webhooks

Receba transaction.paid e transaction.expired no seu endpoint.

Autenticação

Entenda as chaves sk_test_ e sk_live_.

Ir para produção

Passe pelo checklist antes de processar pagamentos reais.