> ## 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.

# Transaccions d'usuaris: historial KYT i risc

> Consulta l'historial de transaccions d'un usuari i com Didit l'usa en el Monitoratge de transaccions. 1,000 al mes inclosos, després $0.001 cadascun.

Cada transacció que envies amb un identificador `vendor_data` (com a sol·licitant o com a contrapart) queda enllaçada amb l'entitat User corresponent. El perfil de l'usuari es converteix en un registre continu de l'activitat de la persona, i Monitoratge de transaccions utilitza aquest historial per alimentar les regles de velocitat i de comportament.

## Recuperar les transaccions d'un usuari

Filtra la llista de Transaccions per `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"
```

Retorna totes les transaccions en què l'usuari és el sol·licitant. Per consultar l'historial des de la banda de la contrapart, filtra a la Business Console (el endpoint públic de llistat només filtra per sol·licitant).

## Com s'enllacen les transaccions amb els usuaris

```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ó inclou fins a quatre parts (sol·licitant, remitent, beneficiari i contrapart). Quan una part inclou `vendor_data`, Didit la vincula a aquest User. Les parts sense `vendor_data` s'emmagatzemen com a instantànies externes (sense enllaç a cap entitat).

Consulta [com enviar transaccions](https://docs.didit.me/ca/transaction-monitoring/transactions.md) per veure el model complet de parts.

## Senyals de risc agregats

Les transaccions alimenten els senyals següents a nivell d'usuari:

| Senyal | Utilitzat per |
| - | - |
| Volum total entrant / sortint | Regles de velocitat, aplicació de llindars |
| Nombre de transaccions en una finestra temporal | Regles de velocitat |
| Contraparts úniques | Regles de comportament |
| Jurisdiccions d'alt risc implicades | Regles de geografia |
| Exposició a contraparts sancionades | Regles de cribratge |
| Varietat de mètodes de pagament | Regles de frau |

Aquests senyals es calculen en temps real i s'avaluen segons les teves [regles de transaccions](https://docs.didit.me/ca/transaction-monitoring/rules.md) actives. Quan una regla coincideix, l'usuari pot passar automàticament a `FLAGGED` o `BLOCKED`, segons l'acció de la regla.

## Com actuen les regles sobre els usuaris

Les `actions` d'una regla de transaccions poden incloure:

* `add_score`: augmenta la puntuació de risc de la transacció.
* `change_status`: estableix l'estat de la transacció (`IN_REVIEW`, `DECLINED`, `AWAITING_USER`).
* `add_tags`: etiqueta la transacció.
* `add_to_list`: afegeix el `vendor_data` de l'usuari a una llista de bloqueig o a una llista personalitzada.

Quan una regla afegeix l'usuari a una llista de bloqueig, la seva entitat User passa a `BLOCKED` i s'activa un webhook `user.status.updated`.

## Monitoratge del comportament d'un usuari

Utilitza la pestanya Transaccions de la pàgina de detall de l'usuari a la Business Console per:

* Veure totes les transaccions en ordre cronològic.
* Filtrar per estat, import, direcció o contrapart.
* Obrir qualsevol transacció per inspeccionar les execucions de regles, l'enriquiment de la IP i els resultats del cribratge de criptoactius.
* Obrir un cas contra l'usuari per fer seguiment d'una investigació.

## Sessions de remediació

Quan una transacció entra a `AWAITING_USER`, Didit crea una **sessió de remediació** enllaçada que obliga l'usuari a completar verificacions addicionals (per exemple, documentació de l'origen dels fons o un document d'identitat actualitzat). La sessió de remediació està vinculada al mateix `vendor_data`; en completar-la, l'estat de la transacció s'actualitza automàticament.

Consulta [estats de les transaccions](https://docs.didit.me/ca/transaction-monitoring/statuses.md) per veure la màquina d'estats completa.

## Ingesta històrica

Per carregar transaccions històriques en una entitat User existent, passa un `txn_date` anterior:

```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]
>
> Les transaccions històriques igualment passen pel motor de regles. Si vols ingerir l'historial **sense** activar regles, utilitza el flux d'importació de la consola, que admet un mode d'ingesta en sec.

## Següents passos

> [card] [Enviar transaccions](https://docs.didit.me/ca/transaction-monitoring/transactions.md)
>
> Referència completa del payload.

> [card] [Regles](https://docs.didit.me/ca/transaction-monitoring/rules.md)
>
> Com avaluen les regles les transaccions i actuen sobre els usuaris.

> [card] [Estats](https://docs.didit.me/ca/transaction-monitoring/statuses.md)
>
> Referència dels estats de la transacció i de la remediació.


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