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

# Monitoraggio delle transazioni: avvio rapido in 10 minuti

> Invia una transazione, vedi le regole attivarsi e collega i webhook con Didit in 10 minuti. 1,000 al mese incluse, poi $0.001 ciascuna.

Configura il Monitoraggio delle transazioni in meno di 10 minuti. Invierai una transazione di prova, controllerai il suo punteggio, abiliterai una regola predefinita, invierai di nuovo la transazione per vederla attivarsi e verificherai che il webhook arrivi.

## Prerequisiti

* Un'applicazione Didit con il Monitoraggio delle transazioni abilitato (*Settings → Transaction Monitoring → Enable*).
* Una chiave API.
* Un endpoint webhook raggiungibile da internet.

## Passaggi

**1. Invia una transazione di riferimento**

```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 '{
    "transaction_id": "baseline-0001",
    "transaction_category": "finance",
    "transaction_details": {
      "direction": "outbound",
      "amount": "500.00",
      "currency": "EUR"
    },
    "subject": { "entity_type": "person", "vendor_data": "user-42", "full_name": "Jane Doe" },
    "counterparty": { "entity_type": "company", "full_name": "Acme Supplier" }
  }'
```

La risposta include:

* `status` – `APPROVED` se nessuna regola è scattata, `IN_REVIEW` / `DECLINED` se ne è scattata almeno una.
* `score` – intero da 0 a 100+.
* `rule_runs` – array di tutte le regole che hanno valutato questa transazione.

**2. Abilita una regola predefinita**

Vai a *Transactions → Rules → Library* nella Business Console. Scegli un preset, ad esempio **Structuring (outbound)**: si attiva quando lo stesso utente invia 20+ trasferimenti in uscita inferiori a €10.000 entro 30 giorni. Abilitala e salva.

**3. Invia transazioni che attivano la regola**

Invia rapidamente 20 transazioni per lo stesso utente, ciascuna di importo inferiore a €10.000:

```bash theme={null}
for i in $(seq 1 20); do
  curl -X POST https://verification.didit.me/v3/transactions/ \
    -H "x-api-key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d "{
      \"transaction_id\": \"struct-$i\",
      \"transaction_category\": \"finance\",
      \"transaction_details\": {
        \"direction\": \"outbound\",
        \"amount\": \"9500.00\",
        \"currency\": \"EUR\"
      },
      \"subject\": { \"entity_type\": \"person\", \"vendor_data\": \"user-42\", \"full_name\": \"Jane Doe\" },
      \"counterparty\": { \"entity_type\": \"company\", \"full_name\": \"Shell Co $i\" }
    }"
done
```

Con il ventesimo invio la regola Structuring scatta. La transazione restituisce `status: IN_REVIEW` e `score` riflette il `score_delta` della regola.

**4. Iscriviti ai webhook delle transazioni**

```bash theme={null}
curl -X POST https://verification.didit.me/v3/webhook/destinations/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "TM events",
    "url": "https://yourapp.com/webhooks/didit-tm",
    "subscribed_events": ["transaction.created", "transaction.status.updated"]
  }'
```

La risposta include `secret_shared_key` – salvalo subito come `DIDIT_WEBHOOK_SECRET` nel tuo `.env`:

```bash theme={null}
DIDIT_WEBHOOK_SECRET=whsec_...   # signing secret returned from webhook registration
```

Poi verifica l'HMAC `X-Signature-V2` su ogni webhook in arrivo prima di fidartene (ricalcola l'HMAC-SHA256 sul corpo canonicalizzato, confronta in tempo costante, rifiuta i timestamp obsoleti). Consulta [TM webhooks](https://docs.didit.me/it/transaction-monitoring/webhooks.md) per i payload e il codice di verifica completo.

Ogni transazione successiva viene inviata al tuo endpoint in tempo reale.

**5. Controlla nella console**

Vai a *Transactions* nella console:

* Vista elenco: transazioni recenti, filtri, azioni multiple.
* Dettaglio transazione: esecuzioni delle regole, arricchimento IP, dettagli delle parti, grafo di rete (per le crypto), alert e casi collegati.

**6. Recupera una transazione tramite API**

```bash theme={null}
curl https://verification.didit.me/v3/transactions/{transaction_id}/ \
  -H "x-api-key: YOUR_API_KEY"
```

Restituisce lo [schema di risposta completo](https://docs.didit.me/it/transaction-monitoring/response-schema.md): punteggio, regole corrispondenti, arricchimento delle parti, screening AML e altro.

## Cosa hai appena configurato

* **Punteggio in tempo reale** – ogni transazione passa attraverso tutte le regole attive.
* **Screening AML** – le controparti vengono sottoposte automaticamente a screening rispetto a sanzioni e notizie negative.
* **Arricchimento IP** – ogni transazione viene arricchita con paese dell'indirizzo IP, ASN e flag VPN/Tor.
* **Webhook** – notifica in tempo reale per ogni transazione.
* **Registro di audit** – esecuzioni delle regole, alert e transizioni di stato sono tutti interrogabili nella console.

## Prossimi passi comuni

> [card] [Guida all'integrazione](https://docs.didit.me/it/transaction-monitoring/integration-guide.md)
>
> Architettura completa e pattern.

> [card] [Approfondimento sulle regole](https://docs.didit.me/it/transaction-monitoring/rules.md)
>
> Come funzionano le regole, condizioni, aggregazioni, azioni.

> [card] [Punteggio di rischio](https://docs.didit.me/it/transaction-monitoring/risk-scoring.md)
>
> Come i punteggi si combinano negli stati.

> [card] [Payload delle transazioni](https://docs.didit.me/it/transaction-monitoring/transactions.md)
>
> Lo schema completo per l'invio delle transazioni.

> [card] [Stati](https://docs.didit.me/it/transaction-monitoring/statuses.md)
>
> Stati di transazioni, alert e casi.

> [card] [Casi](https://docs.didit.me/it/transaction-monitoring/cases.md)
>
> Indaga e risolvi.


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