Ir al contenido

Sandbox (Brasil)

  • En sandbox no se mueve dinero real: el cobro o pago se simula y el saldo se mueve igual que en producción (el cobro acredita, el pago retiene y debita).
  • Los webhooks simulados llevan "sandbox": true.

Envía el campo sandboxSettle al crear el cobro:

ValorResultado
"auto" / "completed"Cobro completado (por defecto)
"failed"Cobro rechazado
"expired"Cobro vencido (payin.expired)

Otro valor → 400. En producción se ignora. Los pagos en sandbox se completan siempre.

Usa el campo simulate en el body, o el header X-Simulate-Error (único medio en los GET):

{ "simulate": "502" }
{ "simulate": "IDEMPOTENCY_IN_FLIGHT" }
{ "simulate": { "status": 422, "code": "PROVIDER_REJECTED" } }

La API devuelve el mismo envoltorio y status que el error real. En producción se ignora.

Ver también la guía general de Modo Sandbox.