In the sandbox, PIX and boleto payments start as waiting_payment and the way they settle is
controlled at two layers: the settlement configuration (default) and magic amounts
(a one-off override for targeted testing).
Layer 1 — Settlement configuration
In the sandbox dashboard you set, per method (PIX and boleto, independently), the settlement mode:
| Mode | Behavior |
|---|
instant (default) | Paid immediately upon creation. |
auto | Created as waiting_payment and automatically paid after auto_delay_minutes (default: 2 min). |
manual | Stays waiting_payment until you click “Simulate Payment” in the dashboard. |
instant (for fast tests) and boleto as manual (to
test the “awaiting payment” screen). Changes apply to subsequent payments.
To test the “awaiting payment” state in your application, use manual mode (or auto with a
delay) and observe the transaction in waiting_payment before it settles.
Layer 2 — Magic amounts (deterministic override)
Regardless of the configured mode, the last two digits of the amount (cents) force a specific outcome.
They take precedence over the configuration — useful for automated tests.
Cents (amount % 100) | Behavior |
|---|
07 | Created as waiting_payment and paid after a short delay |
17 | Created as waiting_payment and expires (cancelled) after the delay |
27 | Created as waiting_payment and stays pending indefinitely (manual settlement) |
$150.07 (15007) → PIX/boleto that auto-pays after the delay.$150.17 (15017) → PIX/boleto that expires.$150.27 (15027) → PIX/boleto that stays pending.$150.00 (15000) → follows the method’s settlement configuration.
Be careful with cents when testing cards: a total ending in 07/17/27 (or 31, which
triggers a chargeback) will change behavior unintentionally. For card tests, prefer amounts
ending in 00.
QR Code and barcode
In the sandbox, PIX returns a copy-and-paste code and boleto returns a barcode and PDF URL —
fixed fictitious values, sufficient to validate your UI. They are not payable in a real banking
app (this is a simulation).
Chargeback (cards only)
PIX and boleto do not support disputes. To simulate a chargeback, use a card with an amount ending
in 31 (e.g., $150.31) or the simulation panel. See Simulate events. 
