> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Transacciones de usuario: historial KYT y riesgo

> Obtén el historial de transacciones de un usuario y cómo Didit lo usa en reglas de monitorización. 1,000 al mes incluidas, luego $0.001 cada una.

Cada transacción que envías con un identificador `vendor_data` (ya sea como solicitante o como contraparte) se vincula a la entidad de usuario correspondiente. El perfil del usuario se convierte en un historial acumulado de la actividad de la persona, y la Monitorización de transacciones usa este historial para aplicar reglas de velocidad y comportamiento basadas en este historial.

## Cómo obtener las transacciones de un usuario

Filtra la lista de transacciones por `vendor_data`:

```bash theme={null}
curl -G https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "vendor_data=user-42" \
  --data-urlencode "page_size=50"
```

Devuelve todas las transacciones en las que el usuario es el solicitante. Para el historial del lado de la contraparte, filtra en la Business Console (el endpoint público de listado solo filtra por solicitante).

## Cómo se vinculan las transacciones a los usuarios

```mermaid theme={null}
flowchart LR
    T["Transaction<br/>txn_id=tx-0001"]
    A["applicant:<br/>vendor_data=user-42"]
    C["counterparty:<br/>vendor_data=user-99"]
    U1[User: user-42]
    U2[User: user-99]
    T --> A
    T --> C
    A -.-> U1
    C -.-> U2
```

Cada transacción incluye hasta cuatro partes (solicitante, remitente, beneficiario y contraparte). Cuando una parte incluye `vendor_data`, Didit la vincula a ese usuario. Las partes sin `vendor_data` se almacenan como instantáneas externas (sin vínculo con ninguna entidad).

Consulta [envío de transacciones](https://docs.didit.me/es/transaction-monitoring/transactions.md) para ver el modelo completo de partes.

## Señales de riesgo agregadas

Las transacciones alimentan las siguientes señales a nivel de usuario:

| Señal | Usada por |
| - | - |
| Volumen total entrante / saliente | Reglas de velocidad, aplicación de umbrales |
| Número de transacciones en una ventana de tiempo | Reglas de velocidad |
| Contrapartes únicas | Reglas de comportamiento |
| Jurisdicciones de alto riesgo involucradas | Reglas geográficas |
| Exposición a contrapartes sancionadas | Reglas de screening |
| Variedad de métodos de pago | Reglas de fraude |

Estas señales se calculan en tiempo real y se evalúan frente a tus [reglas de transacciones](https://docs.didit.me/es/transaction-monitoring/rules.md) activas. Cuando se cumple una regla, el usuario puede pasar automáticamente a `FLAGGED` o `BLOCKED`, según la acción de la regla.

## Cómo actúan las reglas sobre los usuarios

Las `actions` de una regla de transacción pueden incluir:

* `add_score`: aumenta la puntuación de riesgo de la transacción.
* `change_status`: establece el estado de la transacción (`IN_REVIEW`, `DECLINED`, `AWAITING_USER`).
* `add_tags`: etiqueta la transacción.
* `add_to_list`: añade el `vendor_data` del usuario a una lista de bloqueo o a una lista personalizada.

Cuando una regla añade al usuario a una lista de bloqueo, su entidad de usuario pasa a `BLOCKED` y se dispara un webhook `user.status.updated`.

## Monitorización del comportamiento de un usuario

Usa la pestaña Transactions de la página de detalle del usuario en la Business Console para:

* Ver todas las transacciones en orden cronológico.
* Filtrar por estado, importe, dirección y contraparte.
* Abrir cualquier transacción para inspeccionar las ejecuciones de reglas, el enriquecimiento de IP y los resultados del análisis de criptomonedas.
* Abrir un caso contra el usuario para hacer seguimiento de una investigación.

## Sesiones de remediación

Cuando una transacción entra en `AWAITING_USER`, Didit crea una **sesión de remediación** vinculada que requiere que el usuario complete una verificación adicional (por ejemplo, documentación del origen de los fondos o un documento de identidad actualizado). La sesión de remediación está asociada al mismo `vendor_data`: al completarse, el estado de la transacción se actualiza automáticamente.

Consulta [estados de las transacciones](https://docs.didit.me/es/transaction-monitoring/statuses.md) para ver la máquina de estados completa.

## Ingesta histórica

Para cargar transacciones históricas asociadas a una entidad de usuario existente, pasa un `txn_date` en el pasado:

```bash theme={null}
curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "txn_id": "legacy-0001",
    "txn_date": "2024-03-15T10:00:00Z",
    "direction": "INBOUND",
    "amount": "2500.00",
    "currency": "EUR",
    "applicant": { "vendor_data": "user-42" },
    "counterparty": { "name": "Historic payer" }
  }'
```

> [!NOTE]
>
> Las transacciones históricas también pasan por el motor de reglas. Si quieres ingerir el historial **sin** disparar reglas, usa el flujo de importación de la consola, que admite un modo de "ingesta en seco" (dry ingest).

## Próximos pasos

> [card] [Enviar transacciones](https://docs.didit.me/es/transaction-monitoring/transactions.md)
>
> Referencia completa del payload.

> [card] [Reglas](https://docs.didit.me/es/transaction-monitoring/rules.md)
>
> Cómo las reglas evalúan las transacciones y actúan sobre los usuarios.

> [card] [Estados](https://docs.didit.me/es/transaction-monitoring/statuses.md)
>
> Referencia de los estados de transacciones y de remediación.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.