> ## 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 aziendali: cronologia KYT

> Recupera la cronologia delle transazioni di un'azienda in Didit e vedi come l'attività alimenta le regole di Monitoraggio delle transazioni.

Ogni transazione che invii con un identificativo `vendor_data` corrispondente a un'entità Business, come richiedente, ordinante, beneficiario o controparte, viene collegata al profilo di quel Business. Il Business diventa un registro continuo della sua attività, e il Monitoraggio delle transazioni usa questa cronologia per alimentare, a livello di Business, le regole su velocità, comportamento e screening.

## Recupero delle transazioni di un Business

Filtra l'elenco delle transazioni in base al `vendor_data` del Business:

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

Restituisce tutte le transazioni in cui il Business compare come richiedente. Per la cronologia dal lato controparte, filtra nella Business Console (l'endpoint pubblico dell'elenco filtra solo per richiedente).

## Come le transazioni si collegano ai Business

```mermaid theme={null}
flowchart LR
    T["Transaction<br/>txn_id=tx-0042"]
    A["applicant:<br/>vendor_data=biz-acme"]
    C["counterparty:<br/>vendor_data=biz-widgets"]
    B1[Business: biz-acme]
    B2[Business: biz-widgets]
    T --> A
    T --> C
    A -.-> B1
    C -.-> B2
```

Ogni transazione include fino a quattro parti (`applicant`, `remitter`, `beneficiary`, `counterparty`). Quando una parte include un `vendor_data` che corrisponde a un'entità Business della tua applicazione, Didit associa la parte a quel Business. 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.

## Parti di tipo misto

Una singola transazione può includere sia Utenti sia Business tra le sue parti, ad esempio un utente individuale che paga un'azienda:

```json theme={null}
{
  "txn_id": "tx-0099",
  "direction": "OUTBOUND",
  "amount": "500.00",
  "currency": "EUR",
  "applicant": { "vendor_data": "user-42" },
  "counterparty": { "vendor_data": "biz-acme" }
}
```

Oppure un trasferimento B2B tra due aziende:

```json theme={null}
{
  "txn_id": "tx-0100",
  "direction": "OUTBOUND",
  "amount": "120000.00",
  "currency": "USD",
  "applicant": { "vendor_data": "biz-acme" },
  "counterparty": { "vendor_data": "biz-widgets" }
}
```

Didit risolve ogni parte in modo indipendente in base al `vendor_data`: la stessa transazione confluisce nei profili di tutte le entità corrispondenti.

## Segnali di rischio aggregati

Le transazioni alimentano questi segnali a livello di Business:

| Segnale | Usato da |
| - | - |
| Volume totale in entrata / in uscita | Regole di velocità, applicazione di 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 tue [regole sulle transazioni](https://docs.didit.me/it/transaction-monitoring/rules.md) attive. Quando una regola trova corrispondenza, il Business può passare automaticamente a `FLAGGED` o `BLOCKED`, a seconda dell'azione della regola.

## Come le regole agiscono sui Business

Le `actions` di una regola sulle transazioni 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` del Business a una blocklist o a una lista personalizzata.

Quando una regola aggiunge il Business a una blocklist, l'entità Business passa a `BLOCKED` e viene inviato un webhook `business.status.updated`.

## Monitoraggio del comportamento di un Business

Usa la scheda Transactions nella pagina di dettaglio del Business nella Business Console per:

* vedere tutte le transazioni in ordine cronologico.
* filtrare per stato, importo, direzione e controparte.
* aprire una transazione per esaminare le esecuzioni delle regole, l'arricchimento IP e i risultati dello screening crypto.
* aprire un caso relativo al Business per tenere traccia di un'indagine.

## Metodi di pagamento di un Business

Ogni transazione può associare uno o più metodi di pagamento (carte di pagamento, conti bancari, e-wallet, wallet crypto). Quando un metodo di pagamento appartiene a un Business, viene ricondotto a quest'ultimo tramite `vendor_data`: così vedi nella pagina di dettaglio del Business ogni metodo di pagamento che l'azienda ha usato in passato.

## Importazione storica

Per importare transazioni storiche in un Business esistente, passa un `txn_date` con una data 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": "25000.00",
    "currency": "EUR",
    "applicant": { "vendor_data": "biz-acme" },
    "counterparty": { "name": "Historic payer" }
  }'
```

> [!NOTE]
>
> Le transazioni storiche passano comunque dal motore delle regole. Se vuoi importare la cronologia **senza** attivare le regole, usa il flusso di importazione dalla console, che supporta la modalità "dry ingest".

## Passi successivi

> [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 sui Business.

> [card] [Stati](https://docs.didit.me/it/transaction-monitoring/statuses.md)
>
> Riferimento agli stati delle transazioni e agli stati delle azioni correttive.


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