Skip to main content
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: Assim dá para, por exemplo, deixar PIX 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. Exemplos:
  • 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.