Saltar al contenido principal
Además de los escenarios automáticos (por los últimos 4 dígitos de la tarjeta o por el monto del PIX/boleto), el dashboard de sandbox permite forzar manualmente el resultado de un pago o de un contracargo. Es la forma más práctica de probar estados específicos bajo demanda.
Estas acciones se realizan en el dashboard de sandbox (no a través de la API pública con x-api-key). Úsalas para desbloquear el estado que deseas observar en tu integración vía API/webhook.

​
Configurar la liquidación de PIX y boleto

En Sandbox → Configuraciones, define el modo de liquidación por método:
  • PIX y boleto, cada uno con modo instant, auto (con retraso de 0 a 60 minutos) o manual.
Consulta lo que hace cada modo en PIX y boleto de prueba.

​
Simular pago

En el detalle de una transacción/pago en espera (PIX/boleto en waiting_payment), usa “Simular Pago” para forzar un resultado:
AcciónEfecto
PagarMarca el pago como paid (dispara transaction.paid, libera split/wallet).
RechazarMarca como refused.
FallarMarca como failed.
Abrir contestación (in_protest)En un pago aprobado con tarjeta, abre un contracargo e inicia el flujo real de disputa.
Cada acción recorre el mismo pipeline de producción (eventos, webhooks, actualización de saldo) — solo el disparador es manual.

​
Simular contracargo

Para probar el flujo de disputa de extremo a extremo:
  1. Realiza un pago aprobado con tarjeta.
  2. Abre la contestación: usa “Abrir contestación” en el pago (o un monto que termine en 31). Esto crea el contracargo y debita la billetera.
  3. Envía los documentos de defensa (flujo normal de contracargo).
  4. Fuerza el resultado en el panel: ganó (won) o perdió (lost).
Consulta el flujo completo en Contracargos.
Para automatización (pruebas E2E), prefiere los escenarios determinísticos: últimos 4 dígitos de la tarjeta para aprobación/rechazo y monto que termine en 07/17/27/31 para PIX/boleto/contracargo — así no dependes de clics en el panel.