Pular para o conteúdo principal
Além dos cenários automáticos (por last-4 do cartão ou por valor do PIX/boleto), o dashboard de sandbox permite forçar manualmente o desfecho de um pagamento ou de um chargeback. É a forma mais prática de testar estados específicos sob demanda.
Estas ações são feitas no dashboard de sandbox (não pela API pública com x-api-key). Use-as para destravar o estado que você quer observar na sua integração via API/webhook.

​
Configurar a liquidação de PIX e boleto

Em Sandbox → Configurações, defina o modo de liquidação por método:
  • PIX e boleto, cada um com modo instant, auto (com atraso de 0 a 60 minutos) ou manual.
Veja o que cada modo faz em PIX e boleto de teste.

​
Simular pagamento

No detalhe de uma transação/pagamento aguardando (PIX/boleto em waiting_payment), use “Simular Pagamento” para forçar um desfecho:
AçãoEfeito
PagarMarca o pagamento como paid (dispara transaction.paid, libera split/wallet).
RecusarMarca como refused.
FalharMarca como failed.
Abrir contestação (in_protest)Em um pagamento pago de cartão, abre um chargeback e dispara o fluxo real de contestação.
Cada ação percorre o mesmo pipeline de produção (eventos, webhooks, atualização de saldo) — só o gatilho é manual.

​
Simular chargeback

Para testar o fluxo de contestação de ponta a ponta:
  1. Faça um pagamento aprovado com cartão.
  2. Abra a contestação: use “Abrir contestação” no pagamento (ou um valor terminando em 31). Isso cria o chargeback e debita a carteira.
  3. Envie os documentos de defesa (fluxo normal de chargeback).
  4. Force o desfecho no painel: ganhou (won) ou perdeu (lost).
Veja o fluxo completo em Chargebacks.
Para automação (testes E2E), prefira os cenários determinísticos: last-4 do cartão para aprovação/recusa e valor terminando em 07/17/27/31 para PIX/boleto/chargeback — assim você não depende de cliques no painel.