> For the complete documentation index, see [llms.txt](https://yutax.gitbook.io/developer/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://yutax.gitbook.io/developer/caracteristicas/yutax-score.md).

# Yutax Score

El Yutax Score 1.0 es un puntaje de riesgo que resume, en un solo valor numérico, el nivel de confianza y exposición al riesgo de una persona o negocio, **derivado de información verificada y eventos reportados por proveedores participantes, agregados y normalizados por Yutax**.

Este puntaje está diseñado para apoyar decisiones relacionadas con **verificación de identidad, prevención de fraude y evaluación de riesgo operativo**, sin exponer datos personales ni revelar la identidad de las empresas participantes.

El Yutax Score 1.0 **no es un score crediticio tradicional** y no debe interpretarse como tal. Es un **score de riesgo y reputación digital**, enfocado en comportamiento, consistencia y eventos verificables.

***

### ¿Qué representa el Yutax Score?

El Yutax Score refleja una evaluación agregada basada en:

* Historial de eventos negativos (chargebacks, chargeoffs y otros)
* Antigüedad y estabilidad del perfil
* Volumen de cuentas reportadas
* Señales de comportamiento y fraude
* Consistencia del usuario a lo largo del tiempo

El score permite a las empresas **evaluar riesgo de forma rápida y estandarizada**, manteniendo la privacidad del usuario y la neutralidad del sistema.

***

### Rango del Yutax Score

El Yutax Score 1.0 se expresa en un rango de **100 a 900**, donde un valor más alto indica **menor riesgo y mayor nivel de confianza**.

| Rango del score                                    | Status    | Nivel de riesgo | Significado                                                               |
| -------------------------------------------------- | --------- | --------------- | ------------------------------------------------------------------------- |
| <mark style="color:$primary;">**800 – 900**</mark> | Excelente | Muy bajo        | Perfil altamente confiable, estable y sin eventos negativos relevantes.   |
| <mark style="color:green;">**700 – 799**</mark>    | Muy bueno | Bajo            | Riesgo bajo, buen historial y consistencia en el tiempo.                  |
| <mark style="color:$success;">**600 – 699**</mark> | Bueno     | Medio           | Riesgo moderado, puede requerir validaciones adicionales según el caso.   |
| <mark style="color:$warning;">**500 – 599**</mark> | Justo     | Medio–alto      | Riesgo elevado, señales negativas presentes o historial limitado.         |
| <mark style="color:orange;">**300 – 499**</mark>   | Malo      | Alto            | Riesgo alto, eventos negativos relevantes o comportamiento inconsistente. |
| <mark style="color:red;">**100 – 299**</mark>      | Crítico   | Crítico         | Riesgo crítico, fraude confirmado, reincidencia o señales severas.        |

***

### Cómo se obtiene el Yutax Score

El Yutax Score solo puede obtenerse mediante procesos de consulta válidos y justificados, **realizados con el consentimiento del consumidor** y dentro de un caso de uso autorizado.

* **Consultas suaves (Soft inquiries)** realizadas vía API
* **Consultas duras (Hard inquiries)** realizadas vía API
* **Investigaciones realizadas manualmente** en la herramienta de **Investigación Avanzada**

El Yutax Score no es público; está disponible para el consumidor en **Yutax Membership** y para proveedores autorizados vía consultas válidas y/o actualizaciones programadas.

<sup>La disponibilidad del score (tiempo real vs. actualizaciones programadas) depende del tipo de integración, permisos del proveedor y políticas aplicables de uso autorizado.</sup>

> Para más información sobre cómo realizar consultas suaves y duras, sus diferencias y casos de uso, consulta la sección\
> **Características → Verificación de identidad** dentro de esta documentación.

***

### Soft inquiries vs Hard inquiries (resumen)

* **Soft inquiry**
  * Usada para verificación, análisis de riesgo y prevención de fraude
  * No genera impacto directo adicional sobre el perfil
  * Ideal para onboarding y evaluaciones iniciales
* **Hard inquiry**
  * Usada en procesos de mayor sensibilidad o validaciones reforzadas con datos mas completos
  * Puede quedar registrada como evento de consulta
  * Requiere un caso de uso justificado

Ambos tipos de consulta devuelven el **Yutax Score**, el nivel de riesgo y señales asociadas.

***

### Ejemplo de respuesta API (Yutax Score)

Al realizar una consulta suave, consulta dura o una investigación avanzada, la respuesta completa incluye múltiples bloques de información relacionados con identidad, señales y validaciones.

En el contexto del **Yutax Score**, el siguiente bloque representa **únicamente la porción de la respuesta relacionada con el puntaje**:

```json
{
  "credit_snapshot": {
    "score": 340,
    "score_range": {
      "min": 100,
      "max": 399
    }
  }
}
```

Este bloque permite a las empresas:

* Clasificar el perfil dentro de un rango definido
* Aplicar reglas internas basadas en score y status
* Tomar decisiones proporcionales al nivel de riesgo

> La respuesta completa de las consultas incluye información adicional sobre identidad y señales.\
> Para ver la estructura completa del response, consulta la sección\
> **Características → Verificación de identidad**.

***

### Cómo deben usar las empresas el Yutax Score

El Yutax Score está diseñado para **apoyar decisiones o para mejorar la identidad digital del consumidor**, no para actuar como un veredicto único.

Buenas prácticas recomendadas:

* Combinar el score con **Yutax Signals, Investigaciones manuales o propios puntajes de confianza**
* Definir umbrales internos según industria y apetito de riesgo
* Aplicar verificaciones adicionales en rangos intermedios
* Evitar decisiones automáticas basadas en un solo evento

Cada empresa mantiene control total sobre cómo interpreta y utiliza el score.

***

### Factores que influyen en el score

El Yutax Score se calcula a partir de múltiples factores combinados, entre ellos:

* Número de cuentas reportadas
* Antigüedad de la cuenta más antigua
* Presencia de chargebacks
* Existencia de chargeoffs
* Frecuencia y severidad de eventos negativos
* Señales de comportamiento anómalo
* Cambios recientes en el perfil

Ningún factor individual define el score por sí solo.\
El cálculo se basa en **comportamiento acumulado y consistencia en el tiempo**.

***

### Impacto de eventos en el Yutax Score

| Evento                  | Impacto              |
| ----------------------- | -------------------- |
| Chargeback              | Negativo             |
| Chargeoff               | Negativo             |
| Reincidencia de eventos | Negativo acumulativo |
| Robo de identidad       | Sin impacto directo  |
| Antigüedad creciente    | Positivo             |
| Perfil estable          | Positivo             |

Los reportes de robo de identidad **no penalizan el score** y solo generan alertas preventivas.

***

### Cambios y actualizaciones del score

El Yutax Score **no es estático**. Puede cambiar cuando:

* Se reportan nuevos eventos
* Se confirman o resuelven incidentes
* Aumenta la antigüedad del perfil
* Se detectan nuevas señales relevantes

Cuando el cambio es significativo, Yutax puede notificar a las empresas mediante **webhooks**.

***

### Principios clave del Yutax Score

* No es un score crediticio
* No expone datos personales
* No revela fuentes ni empresas reportantes
* Se basa en trazabilidad y equidad
* Es dinámico y contextual

***

### Resumen

* El Yutax Score va de **100 a 900**
* Un score más alto indica mayor confianza
* Incluye un **status claro** (Excelente, Bueno, Malo, Crítico)
* Solo se obtiene mediante **soft inquiries, hard inquiries o investigación avanzada**
* Debe usarse como apoyo a la decisión, no como único criterio

Tú mandas.
