Monitoraggio delle transazioni: avvio rapido in 10 minuti

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

Invia una transazione di riferimento

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.

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.

Invia transazioni che attivano la regola

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

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.

Iscriviti ai webhook delle transazioni

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:

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 per i payload e il codice di verifica completo.Ogni transazione successiva viene inviata al tuo endpoint in tempo reale.

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.

Recupera una transazione tramite API

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

Restituisce lo schema di risposta completo: 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

Guida all'integrazione

Architettura completa e pattern.

Approfondimento sulle regole

Come funzionano le regole, condizioni, aggregazioni, azioni.

Punteggio di rischio

Come i punteggi si combinano negli stati.

Payload delle transazioni

Lo schema completo per l’invio delle transazioni.

Stati

Stati di transazioni, alert e casi.

Casi

Indaga e risolvi.

Primi passi

Funzionalità

Riferimento

Console

Monitoraggio delle transazioni: avvio rapido in 10 minuti

Prerequisiti

Passaggi

Cosa hai appena configurato

Prossimi passi comuni

Guida all'integrazione

Approfondimento sulle regole

Punteggio di rischio

Payload delle transazioni

Stati

Casi

​Prerequisiti

​Passaggi

​Cosa hai appena configurato

​Prossimi passi comuni

Guida all'integrazione

Approfondimento sulle regole

Punteggio di rischio

Payload delle transazioni

Stati

Casi

Prerequisiti

Passaggi

Cosa hai appena configurato

Prossimi passi comuni