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.
Desenlace del cobro
Sección titulada «Desenlace del cobro»Envía el campo sandboxSettle al crear el cobro:
| Valor | Resultado |
|---|---|
"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.
Errores a pedido
Sección titulada «Errores a pedido»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.