Saltar al contenido principal

Consultar estado del PIN de seguridad

Endpoint: GET /auth/pin/status

Permite verificar el estado de configuración del PIN de seguridad del usuario autenticado.

🔐 Requiere autenticación JWT​

Debes enviar un token JWT válido en el header:

Authorization: Bearer <accessToken>

📋 Respuestas​

✅ 200 OK​

  • PIN configurado y activo

    {
      "code": 1001,
      "message": "Authentication successful",
      "data": {
        "pinConfigured": true,
        "pinActive": true,
        "configuredAt": "2025-01-15T10:30:00.000Z",
        "lastUpdated": "2025-01-20T14:45:00.000Z"
      }
    }

  • PIN configurado pero inactivo

    {
      "code": 1001,
      "message": "Authentication successful",
      "data": {
        "pinConfigured": true,
        "pinActive": false,
        "configuredAt": "2025-01-15T10:30:00.000Z",
        "lastUpdated": "2025-01-20T14:45:00.000Z"
      }
    }

  • PIN no configurado

    {
      "code": 1001,
      "message": "Authentication successful",
      "data": {
        "pinConfigured": false,
        "pinActive": false,
        "configuredAt": null,
        "lastUpdated": null
      }
    }

❌ 401 Unauthorized​

  • Sin token válido

    {
      "statusCode": 401,
      "message": "Unauthorized"
    }

📝 Notas​

  • Este endpoint no requiere que el PIN esté configurado previamente
  • Útil para verificar si el usuario necesita configurar PIN por primera vez
  • Los campos configuredAt y lastUpdated son null si nunca se configuró PIN
  • El campo pinActive indica si el sistema PIN está habilitado para el usuario

Información: El sistema PIN proporciona una capa adicional de seguridad que requiere verificación antes de acceder a operaciones sensibles.