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

# Transazioni utente: storico KYT e rischio

> Storico transazioni di un utente in Didit e come alimenta le regole di Monitoraggio delle transazioni. 1,000 al mese incluse, poi $0.001 l'una.

Ogni transazione inviata con un identificatore `vendor_data` (come applicant o come counterparty) viene collegata alla corrispondente entità User. Il profilo dell'utente diventa un registro continuo dell'attività della persona, e Monitoraggio delle transazioni usa questa cronologia per alimentare le regole basate su velocità e comportamento.

## Recupero delle transazioni di un utente

Filtra l'elenco delle Transactions 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"
```

Restituisce tutte le transazioni in cui l'utente è l'applicant. Per la cronologia delle transazioni in cui l'utente è la controparte, filtra nella Business Console (l'endpoint pubblico dell'elenco filtra solo per applicant).

## Come le transazioni si collegano agli utenti

```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
```

Ogni transazione include fino a quattro parti (applicant, remitter, beneficiary, counterparty). Quando una parte include `vendor_data`, Didit la associa a quell'User. Le parti senza `vendor_data` vengono memorizzate come snapshot esterni (senza collegamento a un'entità).

Consulta [invio delle transazioni](https://docs.didit.me/it/transaction-monitoring/transactions.md) per il modello completo delle parti.

## Segnali di rischio aggregati

Le transazioni alimentano i seguenti segnali a livello utente:

| Segnale | Utilizzato da |
| - | - |
| Volume totale in entrata / in uscita | Regole di velocità, applicazione delle soglie |
| Numero di transazioni in una finestra temporale | Regole di velocità |
| Controparti uniche | Regole comportamentali |
| Giurisdizioni ad alto rischio coinvolte | Regole geografiche |
| Esposizione a controparti sanzionate | Regole di screening |
| Varietà dei metodi di pagamento | Regole antifrode |

Questi segnali vengono calcolati in tempo reale e valutati rispetto alle [regole di transazione](https://docs.didit.me/it/transaction-monitoring/rules.md) attive. Quando una regola viene soddisfatta, l'utente può passare automaticamente allo stato `FLAGGED` o `BLOCKED`, a seconda dell'azione della regola.

## Come le regole agiscono sugli utenti

Le `actions` di una regola di transazione possono includere:

* `add_score`: aumenta il punteggio di rischio della transazione.
* `change_status`: imposta lo stato della transazione (`IN_REVIEW`, `DECLINED`, `AWAITING_USER`).
* `add_tags`: applica tag alla transazione.
* `add_to_list`: aggiunge il `vendor_data` dell'utente a una blocklist o a una lista personalizzata.

Quando una regola aggiunge l'utente a una blocklist, la sua entità User passa a `BLOCKED` e viene inviato il webhook `user.status.updated`.

## Monitoraggio del comportamento di un utente

Usa la scheda Transactions nella pagina di dettaglio dell'utente nella Business Console per:

* Visualizzare ogni transazione in ordine cronologico.
* Filtrare per stato, importo, direzione, controparte.
* Aprire una transazione per ispezionare le esecuzioni delle regole, l'arricchimento IP e i risultati dello screening crypto.
* Aprire un caso contro l'utente per monitorare un'indagine.

## Sessioni correttive

Quando una transazione entra in `AWAITING_USER`, Didit crea una **sessione correttiva** collegata che richiede all'utente di completare una verifica aggiuntiva (ad esempio, documentazione sull'origine dei fondi o un documento d'identità aggiornato). La sessione correttiva è associata allo stesso `vendor_data`: al completamento, lo stato della transazione si aggiorna automaticamente.

Consulta [stati delle transazioni](https://docs.didit.me/it/transaction-monitoring/statuses.md) per la macchina a stati completa.

## Importazione storica

Per importare retroattivamente transazioni storiche su un'entità User esistente, passa un `txn_date` nel passato:

```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]
>
> Le transazioni storiche passano comunque attraverso il motore delle regole. Se vuoi importare la cronologia **senza** attivare le regole, usa il flusso di importazione dalla console, che supporta una modalità "dry ingest".

## Prossimi passi

> [card] [Invia transazioni](https://docs.didit.me/it/transaction-monitoring/transactions.md)
>
> Riferimento completo del payload.

> [card] [Regole](https://docs.didit.me/it/transaction-monitoring/rules.md)
>
> Come le regole valutano le transazioni e agiscono sugli utenti.

> [card] [Stati](https://docs.didit.me/it/transaction-monitoring/statuses.md)
>
> Riferimento per gli stati di transazione e correttivi.


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