Screening AML: avvisi e codici di alert

Panoramica

Lo Screening AML genera un set ridotto di tag di avviso nell’array warnings[] di ciascuna voce in aml_screenings[]. I due tag seguenti sono gli unici avvisi AML generati da Didit — tutto il resto visibile su un riscontro è codificato nei campi specifici del riscontro stesso (risk_view, match_score, risk_score, sanction_matches[], …) anziché come avviso. Sia le sessioni di workflow sia l’API AML autonoma emettono POSSIBLE_MATCH_FOUND nello stesso modo. Lo stato restituito sul record AML (Approved, In Review, Declined) è ricavato dallo score aggregato e dalle tue soglie — gli avvisi contrassegnano le stesse condizioni consentendoti di gestirle a livello programmatico. Consulta Punteggio di rischio AML per scoprire come le soglie mappano gli stati.

Avvisi generati

Rischio	Causa	`log_type`	Influisce sullo stato	Risoluzione consigliata
`POSSIBLE_MATCH_FOUND`	Lo `score` aggregato è diverso da zero e superiore a `aml_score_approve_threshold` (predefinito `80`) — almeno un riscontro di possibile corrispondenza supera la tua fascia di rischio. (L’API AML autonoma lo emette anche quando il punteggio è esattamente uguale alla soglia.)	`warning`; passa a `error` quando il punteggio supera anche `aml_score_review_threshold` (predefinito `100`).	`In Review` quando il punteggio è superiore alla soglia di approvazione; `Declined` quando supera la soglia di revisione.	Esamina ogni riscontro in `hits[]`. Usa l’endpoint per lo stato dei riscontri AML per contrassegnare i riscontri come `Confirmed Match`, `False Positive` o `Inconclusive`. Gli aggiornamenti dei riscontri attivano un webhook `data.updated`, ma non ricalcolano lo stato AML — imposta lo stato finale tramite l’endpoint per lo stato AML o mediante revisione nella console.
`COULD_NOT_PERFORM_AML_SCREENING`	Nel record KYC mancano uno o più campi tra `full_name`, `date_of_birth` o `issuing_state`. Non viene effettuata alcuna chiamata di screening fatturabile.	`warning`	Forza `In Review`.	Compila i campi mancanti nel record KYC. Lo Screening AML viene eseguito nuovamente in automatico non appena tutti e tre sono presenti — il log di avviso obsoleto viene rimosso e non è necessario alcun nuovo trigger manuale.

Gli avvisi vengono salvati con feature: "AML" e seguono la struttura standard dell’oggetto avviso.

Impostazioni configurabili

Controlli AML per nodo del workflow (accettati anche come opzioni nell’API AML autonoma):

aml_score_approve_threshold — predefinito 80. Un punteggio diverso da zero superiore a questo valore genera POSSIBLE_MATCH_FOUND e instrada il controllo AML a In Review. I punteggi pari o inferiori a tale soglia non generano l’avviso nei workflow di sessione, indipendentemente dal numero di riscontri.
aml_score_review_threshold — predefinito 100. Un punteggio superiore a questo valore rifiuta automaticamente il controllo AML (con il valore predefinito pari a 100 non si attiva mai finché non lo abbassi).
aml_match_score_threshold — predefinito 93. Classificazione per singolo riscontro: i riscontri con match_score inferiore a questo valore iniziano come False Positive e sono esclusi dal punteggio aggregato; pari o superiori a tale valore iniziano come Unreviewed.
Pesi del punteggio di corrispondenza — aml_name_weight / aml_dob_weight / aml_country_weight, predefiniti 60 / 25 / 15 (la somma deve essere pari a 100). Consulta Punteggio di corrispondenza AML.
Monitoraggio continuo — quando abilitato, lo Screening AML esegue nuovamente l’analisi del soggetto al variare dei dataset e riemette il report insieme a un webhook status.updated (stato modificato) o data.updated (riscontri modificati).

Quando si attiva COULD_NOT_PERFORM_AML_SCREENING, il controllo AML rimane in stato In Review finché non vengono forniti i campi di identità mancanti. Una volta che Didit dispone di nome completo, data di nascita e stato di emissione, lo Screening AML viene eseguito di nuovo automaticamente e l’avviso viene cancellato — non è necessario alcun nuovo trigger manuale.

Esempi

`POSSIBLE_MATCH_FOUND` (punteggio superiore alla soglia di approvazione)

{
  "warnings": [
    {
      "feature": "AML",
      "risk": "POSSIBLE_MATCH_FOUND",
      "additional_data": null,
      "log_type": "warning",
      "short_description": "Possible match found in AML screening",
      "long_description": "The Anti-Money Laundering (AML) screening process identified potential matches with watchlists or high-risk databases, requiring further review.",
      "node_id": "aml-1"
    }
  ]
}

`COULD_NOT_PERFORM_AML_SCREENING` (campi KYC mancanti)

{
  "warnings": [
    {
      "feature": "AML",
      "risk": "COULD_NOT_PERFORM_AML_SCREENING",
      "additional_data": null,
      "log_type": "warning",
      "short_description": "Could not retrieve data from KYC for performing AML Screening",
      "long_description": "The system encountered issues accessing or processing Know Your Customer (KYC) data necessary for conducting the Anti-Money Laundering (AML) screening. please fill the KYC full name, birth date, issuing state and document number to automatically proceed with AML screening.",
      "node_id": "aml-1"
    }
  ]
}

Risorse correlate

Report AML — struttura completa della risposta, campi dei riscontri, semantica dello stato
Punteggio di rischio AML — come viene calcolato il punteggio aggregato
Punteggio di corrispondenza AML — affidabilità per singolo riscontro
Monitoraggio AML continuo — ciclo di vita del monitoraggio
Modelli di dati — Screening AML — schema canonico, incluso l’oggetto avviso

Autenticazione

Verifica

Monitoraggio

Piattaforma

Screening AML: avvisi e codici di alert

Panoramica

Avvisi generati

Impostazioni configurabili

Esempi

`POSSIBLE_MATCH_FOUND` (punteggio superiore alla soglia di approvazione)

`COULD_NOT_PERFORM_AML_SCREENING` (campi KYC mancanti)

Risorse correlate

Tipi di avviso

​Panoramica

​Avvisi generati

​Impostazioni configurabili

​Esempi

​POSSIBLE_MATCH_FOUND (punteggio superiore alla soglia di approvazione)

​COULD_NOT_PERFORM_AML_SCREENING (campi KYC mancanti)

​Risorse correlate

​Tipi di avviso

Panoramica

Avvisi generati

Impostazioni configurabili

Esempi

`POSSIBLE_MATCH_FOUND` (punteggio superiore alla soglia di approvazione)

`COULD_NOT_PERFORM_AML_SCREENING` (campi KYC mancanti)

Risorse correlate

Tipi di avviso