Simulación de errores en sandbox

​

Resumen

​

Cómo funciona

1. Autenticáte con una API key de una organización en sandbox.
2. Llamá a POST /transactions con:
   • externalId que empiece con SIMULATE-ERROR-, o
   • metadata.sandboxErrorCode (canónico) o metadata.error_code (alias).
3. Gu1 responde con el HTTP status y el body correspondientes de inmediato (o tras un delay acotado en timeout). No se escribe ninguna fila en transactions.

​

Prioridad al elegir el código

1. metadata.sandboxErrorCode (si está y es reconocido)
2. metadata.error_code (si está y es reconocido)
3. Sufijo después de SIMULATE-ERROR- en externalId (por ejemplo SIMULATE-ERROR-TIMEOUT)

​

Catálogo

​

Alias útiles

​

Ejemplos

​

Timeout (indisponibilidad / sin respuesta a tiempo)

curl -X POST "https://api.gu1.ai/transactions" \
  -H "Authorization: Bearer YOUR_SANDBOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "externalId": "SIMULATE-ERROR-TIMEOUT",
    "type": "PAYMENT",
    "amount": 100,
    "currency": "USD"
  }'

​

Elegir el error con metadata

curl -X POST "https://api.gu1.ai/transactions" \
  -H "Authorization: Bearer YOUR_SANDBOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "externalId": "txn-sandbox-any-id",
    "type": "PAYMENT",
    "amount": 100,
    "currency": "USD",
    "metadata": {
      "sandboxErrorCode": "SANDBOX_SIMULATED_UNAVAILABLE"
    }
  }'

"metadata": { "error_code": "SANDBOX_SIMULATED_UNAVAILABLE" }

​

Ejemplo de body 504

{
  "success": false,
  "error": {
    "code": "SANDBOX_SIMULATED_TIMEOUT",
    "message": "Sandbox simulated gateway timeout (controlled delay; the connection is not left hanging)"
  }
}

​

Alcance

• Solo aplica a POST /transactions individual. Los endpoints de batch no están cubiertos.
• Fallos de auth / permisos (401 / 403 del middleware) no se simulan acá — usá una key o rol inválido si los necesitás.
• Los creates exitosos (201) no cambian; esta feature solo simula errores.

​

Relacionado

• Crear transacción
• Overview de monitoreo de transacciones