Avisos e códigos de alerta de Triagem AML

Visão geral

A triagem AML emite um conjunto reduzido de etiquetas de aviso no array warnings[] de cada entrada em aml_screenings[]. As duas etiquetas abaixo são os únicos avisos de AML que a Didit produz — tudo o resto apresentado numa correspondência está codificado nos próprios campos da correspondência (risk_view, match_score, risk_score, sanction_matches[], …) em vez de como aviso. Tanto as sessões de fluxo como a API autónoma de AML emitem POSSIBLE_MATCH_FOUND da mesma forma. O estado devolvido no registo de AML (Approved, In Review, Declined) deriva do score agregado e dos seus limiares — os avisos sinalizam essas mesmas condições para que possa reagir a elas programaticamente. Consulte Pontuação de risco AML para saber como os limiares são mapeados para o estado.

Avisos gerados

Risco	Causa	`log_type`	Afeta o estado	Mitigação recomendada
`POSSIBLE_MATCH_FOUND`	O `score` agregado é diferente de zero e superior a `aml_score_approve_threshold` (predefinição `80`) — pelo menos uma correspondência potencial ultrapassa a sua faixa de risco. (A API autónoma de AML também o emite quando a pontuação é exatamente igual ao limiar.)	`warning`; escala para `error` quando a pontuação também excede o `aml_score_review_threshold` (predefinição `100`).	`In Review` quando a pontuação está acima do limiar de aprovação; `Declined` quando está acima do limiar de revisão.	Reveja cada correspondência em `hits[]`. Utilize o endpoint de estado de correspondência de AML para marcar correspondências como `Confirmed Match`, `False Positive` ou `Inconclusive`. As atualizações de correspondências acionam um webhook `data.updated`, mas não voltam a calcular o estado de AML — defina o estado final através do endpoint de estado de AML ou da revisão na consola.
`COULD_NOT_PERFORM_AML_SCREENING`	O registo de KYC não tem um ou mais dos seguintes campos: `full_name`, `date_of_birth` ou `issuing_state`. Não é efetuada nenhuma chamada faturável de triagem.	`warning`	Força `In Review`.	Preencha os campos em falta no registo de KYC. A AML é executada novamente de forma automática assim que os três estiverem presentes — o registo de aviso obsoleto é removido e não é necessário nenhum novo acionamento manual.

Os avisos são armazenados com feature: "AML" e seguem a estrutura padrão do objeto de aviso.

Definições configuráveis

Controlos de AML por nó de fluxo (também aceites como opções na API autónoma de AML):

aml_score_approve_threshold — predefinição 80. Uma pontuação diferente de zero superior a este valor produz POSSIBLE_MATCH_FOUND e encaminha a verificação de AML para In Review. Pontuações iguais ou inferiores a este valor não produzem o aviso em fluxos de sessão, independentemente do número de correspondências.
aml_score_review_threshold — predefinição 100. Uma pontuação superior a este valor recusa automaticamente a verificação de AML (com a predefinição de 100, nunca é acionada até que a reduza).
aml_match_score_threshold — predefinição 93. Classificação por correspondência: correspondências com match_score abaixo deste valor começam como False Positive e são excluídas da pontuação agregada; iguais ou superiores começam como Unreviewed.
Pesos da pontuação de correspondência — aml_name_weight / aml_dob_weight / aml_country_weight, predefinições 60 / 25 / 15 (devem somar 100). Consulte Pontuação de correspondência AML.
Monitorização contínua — quando ativada, a AML realiza uma nova triagem do sujeito à medida que os conjuntos de dados mudam e volta a emitir o relatório juntamente com um webhook status.updated (estado alterado) ou data.updated (correspondências alteradas).

Quando COULD_NOT_PERFORM_AML_SCREENING é acionado, a verificação de AML permanece em In Review até que os campos de identidade em falta sejam fornecidos. Assim que a Didit tiver o nome completo, a data de nascimento e o estado emissor, a AML é executada novamente de forma automática e o aviso é removido — não é necessário voltar a acioná-lo manualmente.

Exemplos

`POSSIBLE_MATCH_FOUND` (pontuação acima do limiar de aprovação)

{
  "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` (campos de KYC em falta)

{
  "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"
    }
  ]
}

Relacionado

Relatório de AML — formato completo da resposta, campos de correspondências, semântica do estado
Pontuação de risco AML — como a pontuação agregada é calculada
Pontuação de correspondência AML — confiança por correspondência
Monitorização AML contínua — ciclo de vida da monitorização
Modelos de dados — Triagem AML — esquema canónico, incluindo o Objeto de aviso

Autenticação

Verificação

Monitorização

Plataforma

Avisos e códigos de alerta de Triagem AML

Visão geral

Avisos gerados

Definições configuráveis

Exemplos

`POSSIBLE_MATCH_FOUND` (pontuação acima do limiar de aprovação)

`COULD_NOT_PERFORM_AML_SCREENING` (campos de KYC em falta)

Relacionado

Tipos de aviso

​Visão geral

​Avisos gerados

​Definições configuráveis

​Exemplos

​POSSIBLE_MATCH_FOUND (pontuação acima do limiar de aprovação)

​COULD_NOT_PERFORM_AML_SCREENING (campos de KYC em falta)

​Relacionado

​Tipos de aviso

Visão geral

Avisos gerados

Definições configuráveis

Exemplos

`POSSIBLE_MATCH_FOUND` (pontuação acima do limiar de aprovação)

`COULD_NOT_PERFORM_AML_SCREENING` (campos de KYC em falta)

Relacionado

Tipos de aviso