Vai al contenuto principale
PATCH
curl

Cosa fa

Lo screening AML restituisce un elenco di hit, ovvero potenziali corrispondenze con liste delle sanzioni, database PEP, watchlist e notizie negative. Ogni hit ha un review_status (il suo esito), che parte come Unreviewed o False Positive in base al punteggio di corrispondenza. Questo endpoint permette al tuo team (o alla tua automazione) di registrare una decisione su ciascun hit, senza modificare la decisione complessiva della sessione. Trovi gli hit e i loro ID nella decisione della sessione: nell’array hits del controllo AML, dove l’id di ogni hit è l’hit_id da passare qui. L’id di un hit è hit_ seguito da 24 caratteri esadecimali e resta invariato quando il soggetto viene sottoposto di nuovo a screening. L’ID di un hit restituito nel formato precedente è comunque accettato; la risposta indica sempre l’hit con il suo id attuale.

Stati di revisione

Le decisioni del revisore vengono conservate durante i nuovi screening del monitoraggio continuo: un hit contrassegnato come False Positive mantiene quello stato quando il provider ripete lo screening dell’entità.

Aggiornare un singolo hit

PATCH /v3/session/{sessionId}/update-aml-hit-status/
Per una sessione con più controlli AML (workflow a grafo), aggiungi ?node_id=feature_aml_1 all’URL oppure includi "node_id" nel corpo della richiesta per indirizzare un controllo specifico.

Aggiornare più hit insieme

PATCH /v3/session/{sessionId}/bulk-update-aml-hit-status/ Passa hit_updates, un elenco di coppie { hit_id, review_status }. L’operazione è tutto o niente: se un hit_id non viene trovato, la richiesta restituisce 404 e nessun hit viene modificato.
Una chiamata in blocco riuscita invia un unico webhook data.updated e registra una sola voce di attività che copre tutte le modifiche.

Cosa succede dopo un aggiornamento

  • Webhook: un evento data.updated viene attivato per la sessione.
  • Registro di audit: la modifica viene registrata nel registro di revisione della sessione, con l’attore (chiave API o utente), ed è visibile nella cronologia delle attività della console.
  • Lo stato complessivo del passaggio AML non cambia: modificare l’esito di un hit non modifica, di per sé, lo stato del passaggio AML né la decisione della sessione. Per cambiare lo stato del passaggio AML (Approved / Declined / In Review), usa update-feature-status. Per cambiare la decisione della sessione, usa update-status.

Supporto KYC e KYB

Funziona sia per le sessioni Verifica degli utenti (KYC) sia per quelle Verifica aziendale (KYB): Didit risolve il sessionId in entrambi i casi. Per il KYB, lo screening AML viene eseguito sull’azienda e sulle sue persone chiave, e ogni controllo AML espone i propri hit.

Autorizzazione

Richiede il privilegio write:sessions, con una chiave API del client (x-api-key) oppure un’intestazione di autorizzazione dell’utente.

Errori

Contenuti correlati

Autorizzazioni

x-api-key
string
header
obbligatorio

La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys.

Parametri del percorso

sessionId
string<uuid>
obbligatorio

UUID della sessione di verifica. Accetta sia ID di sessione utente (KYC) sia ID di sessione aziendale (KYB): il servizio risolve l'ID per entrambi i tipi di sessione.

Esempio:

"11111111-2222-3333-4444-555555555555"

Parametri della query

node_id
string

ID del nodo del grafo del workflow. Richiesto solo quando la sessione contiene più controlli AML (uno per nodo); omettere per le sessioni con un singolo controllo AML.

Esempio:

"feature_aml_1"

Corpo

application/json
hit_id
string
obbligatorio

L'id dell'hit nell'array hits del controllo AML (hit_...). Un id hit restituito nel formato precedente viene ancora accettato.

Esempio:

"hit_7c1e9a40b2d35f86e0a4c912"

review_status
enum<string>
obbligatorio

Il nuovo stato di revisione per il match.

Opzioni disponibili:
Unreviewed,
Confirmed Match,
False Positive,
Inconclusive
Esempio:

"False Positive"

node_id
string

ID opzionale del nodo del grafo. Usalo (qui o come parametro di query) quando la sessione include più controlli AML.

Esempio:

"feature_aml_1"

Risposta

Stato di revisione del riscontro aggiornato.

message
string
obbligatorio

Sempre Hit status updated successfully.

hit_id
string
obbligatorio

L'id dell'hit aggiornato, così come restituito dalla decisione della sessione, anche se la richiesta ha indicato l'hit tramite un id nel formato precedente.

review_status
enum<string>
obbligatorio

Lo stato di revisione ora memorizzato per la corrispondenza (hit).

Opzioni disponibili:
Unreviewed,
Confirmed Match,
False Positive,
Inconclusive
Ultima modifica il 7 novembre 2026