En el sandbox, PIX y boleto comienzan como waiting_payment (en espera) y la forma en que se liquidan se
controla en dos capas: la configuración de liquidación (predeterminada) y los valores mágicos
(override puntual para pruebas).
Capa 1 — Configuración de liquidación
En el panel del sandbox usted define, por método (PIX y boleto, independientes), el modo de liquidación:
| Modo | Comportamiento |
|---|
instant (predeterminado) | Se paga en el momento de la creación. |
auto | Nace como waiting_payment y se paga automáticamente después de auto_delay_minutes (predeterminado: 2 min). |
manual | Permanece en waiting_payment hasta que usted haga clic en “Simular Pago” en el dashboard. |
instant (pruebas rápidas) y boleto manual (probar la
pantalla de “esperando pago”). Los cambios aplican a los próximos pagos.
Para probar el estado “esperando pago” de su aplicación, use el modo manual (o auto con
un delay) y observe la transacción en waiting_payment antes de liquidar.
Capa 2 — Valores mágicos (override determinístico)
Independientemente del modo configurado, los dos últimos dígitos del valor (centavos) fuerzan un resultado.
Tienen precedencia sobre la configuración — útiles para pruebas automatizadas.
Centavos (valor % 100) | Comportamiento |
|---|
07 | Nace como waiting_payment y se paga después de un pequeño delay |
17 | Nace como waiting_payment y expira (se cancela) después del delay |
27 | Nace como waiting_payment y permanece pendiente para siempre (liquidación manual) |
R$ 150,07 (15007) → PIX/boleto que se auto-paga después del delay.R$ 150,17 (15017) → PIX/boleto que expira.R$ 150,27 (15027) → PIX/boleto que permanece en espera.R$ 150,00 (15000) → sigue la configuración de liquidación del método.
Tenga cuidado con los centavos al probar tarjeta: un total que termine en 07/17/27 (o 31, que
dispara chargeback) cambia el comportamiento de forma no intencional. Para pruebas de tarjeta, prefiera valores
que terminen en 00.
Código QR y línea digitada
En el sandbox, PIX devuelve un código copia-y-pega y el boleto devuelve línea digitada y URL de PDF —
valores ficticios fijos, suficientes para validar su UI. No son pagables en una app bancaria
real (es una simulación).
Chargeback (solo tarjeta)
PIX y boleto no tienen disputas. Para simular un chargeback, use una tarjeta con valor que termine
en 31 (ej.: R$ 150,31) o el panel de simulación. Consulte Simular eventos. 
