Sandbox e Mocks
Use o sandbox para simular o ciclo de vida completo de uma transação sem dinheiro real.
O que dá para testar
- Criação de merchants e cobranças Pix.
- Confirmação de pagamento (transição
PENDING→PAID). - Entrega de webhooks na sua
callbackUrl. - Saques e divisões (splits).
- Cenários de erro (saldo insuficiente, cobrança expirada, chave Pix inválida).
Simulando eventos
No sandbox, pagamentos não passam por um banco real. A confirmação pode ser disparada pelo painel ou por endpoints de teste, permitindo validar que seu sistema:
- Recebe o webhook,
- Verifica a assinatura,
- Trata idempotência (mesmo evento entregue mais de uma vez),
- Atualiza o estado do pedido.
Recomendações
- Teste reentrega de webhook: nosso sistema reenvia em caso de falha — seu endpoint precisa ser idempotente.
- Teste timeouts e instabilidades momentâneas para validar seus retries.
- Valide os códigos de erro que você trata (ver Erros).
Dica: trate o webhook como a fonte de verdade do status. Polling serve apenas como reconciliação de contingência.