Vai al contenuto principale
PATCH
curl
Per decidere sulle singole corrispondenze invece che sull’intero controllo, usa Aggiorna lo stato di un riscontro AML. Per sapere come vengono prodotti i risultati e gli stati dello screening, consulta Screening AML.

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 (il session_id restituito da POST /v3/session/). Accetta sia ID di sessione di Verifica degli utenti (KYC) sia di Verifica aziendale (KYB): il server risolve l'ID per entrambi i tipi di sessione. Deve essere un UUID ben formato; un valore malformato non corrisponde alla route e restituisce una pagina HTML 404.

Esempio:

"11111111-2222-3333-4444-555555555555"

Parametri della query

node_id
string

ID del nodo del grafo del workflow relativo al controllo AML da aggiornare. Necessario solo se la sessione ha eseguito più di un passaggio AML. Ha la precedenza rispetto a node_id nel corpo.

Esempio:

"feature_aml_1"

Corpo

application/json
status
enum<string>
obbligatorio

Nuovo stato del controllo AML.

Opzioni disponibili:
Not Finished,
Approved,
Declined,
In Review,
Resub Requested
Esempio:

"Approved"

node_id
string

ID del nodo del grafo del workflow relativo al controllo AML, in alternativa al parametro di query.

Esempio:

"feature_aml_1"

Risposta

Stato del controllo AML impostato (o invariato se aveva già questo valore).

message
string
obbligatorio

Sempre AML status updated successfully.

status
enum<string>
obbligatorio

Stato del controllo AML attuale.

Opzioni disponibili:
Not Finished,
Approved,
Declined,
In Review,
Resub Requested
previous_status
enum<string>
obbligatorio

Stato prima della chiamata. Uguale a status se nulla è cambiato.

Opzioni disponibili:
Not Finished,
Approved,
Declined,
In Review,
Resub Requested
Ultima modifica il 7 novembre 2026