Avisos de triagem AML e códigos de alerta

Visão geral

A triagem AML emite um pequeno conjunto de tags de aviso no array warnings[] de cada entrada em aml_screenings[]. As duas tags abaixo são os únicos avisos AML que a Didit produz. Todo o resto que você vê em uma correspondência é codificado nos próprios campos da correspondência (risk_view, match_score, risk_score, sanction_matches[], …), e não como aviso. Tanto as sessões de workflow quanto a API AML independente emitem POSSIBLE_MATCH_FOUND da mesma forma. O status retornado no registro AML (Approved, In Review, Declined) é derivado do score agregado e dos seus limiares. Os avisos marcam as mesmas condições para que você possa reagir a elas de forma programática. Consulte pontuação de risco AML para ver como os limiares se convertem em status.

Avisos produzidos

Risco	Causa	`log_type`	Afeta o status	Correção recomendada
`POSSIBLE_MATCH_FOUND`	O `score` agregado é diferente de zero e está acima do `aml_score_approve_threshold` (padrão `80`): pelo menos uma possível correspondência ultrapassa a sua faixa de risco. (A API AML independente também o emite quando a pontuação é exatamente igual ao limiar.)	`warning`; passa para `error` quando a pontuação também excede o `aml_score_review_threshold` (padrão `100`).	`In Review` quando a pontuação está acima do limiar de aprovação; `Declined` quando está acima do limiar de revisão.	Revise cada correspondência em `hits[]`. Use o endpoint de status de correspondências AML para marcar as correspondências como `Confirmed Match`, `False Positive` ou `Inconclusive`. As atualizações de correspondências disparam um webhook `data.updated`, mas não recalculam o status AML. Defina o status final pelo endpoint de status AML ou pela revisão no console.
`COULD_NOT_PERFORM_AML_SCREENING`	Falta no registro KYC um ou mais destes campos: `full_name`, `date_of_birth` ou `issuing_state`. Nenhuma chamada de análise faturável é feita.	`warning`	Força `In Review`.	Preencha os campos ausentes no registro KYC. A análise AML é executada novamente de forma automática assim que os três campos estiverem presentes: o registro de aviso desatualizado é removido e não é preciso acioná-la novamente de forma manual.

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

Configurações ajustáveis

Controles AML por nó do fluxo (também aceitos como opções na API AML independente):

aml_score_approve_threshold: padrão 80. Uma pontuação diferente de zero acima dele produz POSSIBLE_MATCH_FOUND e encaminha a verificação AML para In Review. Pontuações iguais ou inferiores a ele não produzem o aviso em fluxos de sessão, independentemente do número de correspondências.
aml_score_review_threshold: padrão 100. Uma pontuação acima dele recusa automaticamente a verificação AML (com o padrão de 100, isso nunca acontece até que você o reduza).
aml_match_score_threshold: padrão 93. Classificação por correspondência: correspondências com match_score abaixo dele começam como False Positive e são excluídas da pontuação agregada; iguais ou acima dele, começam como Unreviewed.
Pesos da pontuação de correspondência: aml_name_weight / aml_dob_weight / aml_country_weight, padrões 60 / 25 / 15 (a soma deve ser 100). Consulte pontuação de correspondência AML.
Monitoramento contínuo: quando ativado, a análise AML reavalia o titular à medida que as bases de dados mudam e emite novamente o relatório, além de um webhook status.updated (status alterado) ou data.updated (correspondências alteradas).

Quando COULD_NOT_PERFORM_AML_SCREENING é disparado, a verificação AML permanece em In Review até que os campos de identidade ausentes sejam fornecidos. Assim que a Didit tiver o nome completo, a data de nascimento e o estado emissor, a análise AML é executada novamente de forma automática e o aviso desaparece. Não há novo acionamento manual.

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 KYC ausentes)

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

Relacionados

Relatório AML: formato completo da resposta, campos das correspondências, semântica dos status
Pontuação de risco AML: como a pontuação agregada é calculada
Pontuação de correspondência AML: confiança por correspondência
Monitoramento AML contínuo: ciclo de vida do monitoramento
Modelos de dados: triagem AML: esquema canônico, incluindo o objeto de aviso

Autenticação

Verificação

Monitoramento

Plataforma

Avisos de triagem AML e códigos de alerta

Visão geral

Avisos produzidos

Configurações ajustáveis

Exemplos

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

`COULD_NOT_PERFORM_AML_SCREENING` (campos KYC ausentes)

Relacionados

Tipos de aviso

​Visão geral

​Avisos produzidos

​Configurações ajustáveis

​Exemplos

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

​COULD_NOT_PERFORM_AML_SCREENING (campos KYC ausentes)

​Relacionados

​Tipos de aviso

Visão geral

Avisos produzidos

Configurações ajustáveis

Exemplos

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

`COULD_NOT_PERFORM_AML_SCREENING` (campos KYC ausentes)

Relacionados

Tipos de aviso