No sandbox, PIX e boleto começam como waiting_payment (aguardando) e a forma como liquidam é
controlada em duas camadas: a configuração de liquidação (padrão) e os valores mágicos
(override pontual para testes).
Camada 1 — Configuração de liquidação
No painel do sandbox você define, por método (PIX e boleto, independentes), o modo de liquidação:
| Modo | Comportamento |
|---|
instant (padrão) | Paga na hora da criação. |
auto | Nasce waiting_payment e é pago automaticamente após auto_delay_minutes (padrão: 2 min). |
manual | Fica waiting_payment até você clicar em “Simular Pagamento” no dashboard. |
instant (testes rápidos) e boleto manual (testar a
tela de “aguardando pagamento”). As mudanças valem para os próximos pagamentos.
Para testar o estado “aguardando pagamento” da sua aplicação, use o modo manual (ou auto com
um delay) e observe a transação em waiting_payment antes de liquidar.
Camada 2 — Valores mágicos (override determinístico)
Independente do modo configurado, os dois últimos dígitos do valor (centavos) forçam um desfecho.
Eles têm precedência sobre a configuração — úteis para testes automatizados.
Centavos (valor % 100) | Comportamento |
|---|
07 | Nasce waiting_payment e paga após um pequeno delay |
17 | Nasce waiting_payment e expira (cancela) após o delay |
27 | Nasce waiting_payment e fica pendente para sempre (liquidação manual) |
R$ 150,07 (15007) → PIX/boleto que auto-paga após o delay.R$ 150,17 (15017) → PIX/boleto que expira.R$ 150,27 (15027) → PIX/boleto que fica aguardando.R$ 150,00 (15000) → segue a configuração de liquidação do método.
Cuidado com os centavos ao testar cartão: um total terminando em 07/17/27 (ou 31, que
dispara chargeback) muda o comportamento sem querer. Para testes de cartão, prefira valores
terminando em 00.
QR Code e linha digitável
No sandbox, o PIX retorna um copia-e-cola e o boleto retorna linha digitável e URL de PDF —
valores fictícios fixos, suficientes para validar sua UI. Eles não são pagáveis num app bancário
real (é simulação).
Chargeback (somente cartão)
PIX e boleto não têm contestação. Para simular chargeback, use um cartão com valor terminando
em 31 (ex.: R$ 150,31) ou o painel de simulação. Veja Simular eventos. 
