Sandbox
Simuladores para testar cada caminho sem dinheiro de verdade.
Com uma chave sk_sandbox_…, as rotas /v1/sandbox/* simulam o que o banco faria. Cada simulação é enfileirada e
percorre o mesmo fluxo da produção — aviso do banco, confirmação do Pix, eventos e webhooks. Em produção essas
rotas respondem 404.
| Simulação | Rota | Opções |
|---|---|---|
| Pagamento de cobrança | POST /sandbox/charges/{id}/simulate_payment |
amount, delay_seconds, duplicate_webhook, out_of_order, paid_on (com vencimento) |
| Expiração | POST /sandbox/charges/{id}/simulate_expiration |
— |
| Pix sem cobrança | POST /sandbox/payments/simulate_unmatched |
amount |
| Pix pelo QR impresso | POST /sandbox/static_qrs/{id}/simulate_payment |
amount |
| MED | POST /sandbox/payments/{id}/simulate_med |
outcome: refunded ou released |
A página de checkout (checkout_url) também tem, no sandbox, um botão "Simular pagamento".
Teste de propósito os casos difíceis: duplicate_webhook (o mesmo evento duas vezes) e out_of_order
(charge.paid antes de charge.created). A sua integração precisa aguentar os dois.