Respuesta Estándar

El endpoint POST /api/v1/connection siempre responde con el mismo envoltorio, independientemente del módulo o método invocado.

Estructura exitosa

{
  "statusCode": 200,
  "body": {
    "success": true,
    "status": 200,
    "result": { },
    "message": "Descripción del resultado"
  }
}

Campo	Tipo	Descripción
statusCode	integer	HTTP status code externo
body.success	boolean	true si la operación fue exitosa
body.status	integer	Código de estado interno (puede ser 200, 201, etc.)
body.result	object	Datos de la respuesta (varía por operación)
body.message	string	Descripción legible del resultado

Estructura de error

{
  "statusCode": 500,
  "body": {
    "success": false,
    "status": 500,
    "error": "Descripción técnica del error",
    "message": "Descripción del error",
    "data": { }
  }
}

Campo	Tipo	Descripción
body.error	string	Mensaje técnico del error
body.message	string	Mensaje legible
body.data	object	Datos adicionales de contexto (opcional)

Respuestas de los endpoints STP

Los endpoints /stp/v1/* NO usan este envoltorio. Responden directamente:

// Éxito
{ "message": "recibido" }

// Devolución (abono rechazado)
{ "message": "devolver", "id": 1 }

// Error de firma
{ "message": "error validando firma" }