> ## 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.

# PIX e boleto de teste

> Como controlar a liquidação de PIX e boleto no sandbox: instant, auto, manual e cenários por valor.

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

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.

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

## 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) |

**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.

<Warning>
  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`.
</Warning>

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