> ## Documentation Index
> Fetch the complete documentation index at: https://docs.z2pay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Simular eventos

> Force manualmente o desfecho de pagamentos e chargebacks pelo painel do sandbox.

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.

<Note>
  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.
</Note>

## 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](/pt-BR/sandbox/pix-boleto).

## Simular pagamento

No detalhe de uma transação/pagamento **aguardando** (PIX/boleto em `waiting_payment`), use
**"Simular Pagamento"** para forçar um desfecho:

| Ação                                 | Efeito                                                                                        |
| ------------------------------------ | --------------------------------------------------------------------------------------------- |
| **Pagar**                            | Marca o pagamento como `paid` (dispara `transaction.paid`, libera split/wallet).              |
| **Recusar**                          | Marca como `refused`.                                                                         |
| **Falhar**                           | Marca 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](/pt-BR/chargebacks).

<Tip>
  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.
</Tip>