Advertències de cribratge AML i codis d'alerta

Visió general

El cribratge AML emet un conjunt reduït d’etiquetes d’advertència a la matriu warnings[] de cada entrada d’aml_screenings[]. Les dues etiquetes següents són les úniques advertències d’AML que Didit genera; tota la resta del que veus en una coincidència està codificat en els camps de la mateixa coincidència (risk_view, match_score, risk_score, sanction_matches[], …) en lloc de com a advertència. Tant les sessions de flux de treball com l’API d’AML independent emeten POSSIBLE_MATCH_FOUND de la mateixa manera. L’estat que es retorna al registre d’AML (Approved, In Review, Declined) es deriva de la score agregada i dels teus llindars; les advertències etiqueten les mateixes condicions perquè puguis reaccionar-hi programàticament. Consulta Puntuació de risc AML per veure com es mapegen els llindars als estats.

Advertències generades

Risc	Causa	`log_type`	Afecta l’estat	Acció correctora recomanada
`POSSIBLE_MATCH_FOUND`	La `score` agregada és diferent de zero i supera `aml_score_approve_threshold` (per defecte `80`): almenys una possible coincidència creua la teva franja de risc. (L’API d’AML independent també l’emet quan la puntuació és exactament igual al llindar).	`warning`; escala a `error` quan la puntuació també supera `aml_score_review_threshold` (per defecte `100`).	`In Review` quan la puntuació supera el llindar d’aprovació; `Declined` quan supera el llindar de revisió.	Revisa cada coincidència a `hits[]`. Utilitza l’endpoint d’estat de coincidències d’AML per marcar les coincidències com a `Confirmed Match`, `False Positive` o `Inconclusive`. Les actualitzacions de coincidències disparen un webhook `data.updated` però no recalculen l’estat d’AML: estableix l’estat final mitjançant l’endpoint d’estat d’AML o mitjançant la revisió a la consola.
`COULD_NOT_PERFORM_AML_SCREENING`	Al registre de KYC li falta un o més dels camps `full_name`, `date_of_birth` o `issuing_state`. No es fa cap crida de cribratge facturable.	`warning`	Força `In Review`.	Emplena els camps que falten al registre de KYC. L’AML es torna a executar automàticament un cop hi són tots tres: el registre d’advertència obsolet s’elimina i no cal cap reactivació manual.

Les advertències s’emmagatzemen amb feature: "AML" i segueixen l’estructura estàndard de l’objecte d’advertència.

Paràmetres configurables

Controls d’AML per node del flux de treball (també acceptats com a opcions a l’API d’AML independent):

aml_score_approve_threshold — per defecte 80. Una puntuació diferent de zero per sobre d’aquest valor produeix POSSIBLE_MATCH_FOUND i desvia la comprovació d’AML a In Review. Les puntuacions iguals o inferiors no produeixen l’advertència en fluxos de treball de sessió, independentment del nombre de coincidències.
aml_score_review_threshold — per defecte 100. Una puntuació per sobre d’aquest valor rebutja automàticament la comprovació d’AML (amb el valor per defecte de 100, això no s’activa mai tret que el redueixis).
aml_match_score_threshold — per defecte 93. Classificació per coincidència: les coincidències amb un match_score inferior comencen com a False Positive i s’exclouen de la puntuació agregada; si és igual o superior, comencen com a Unreviewed.
Ponderacions de la puntuació de coincidència — aml_name_weight / aml_dob_weight / aml_country_weight, valors per defecte 60 / 25 / 15 (han de sumar 100). Consulta Puntuació de coincidència AML.
Monitoratge continu — quan està habilitat, l’AML torna a fer el cribratge del subjecte a mesura que canvien els conjunts de dades i torna a emetre l’informe juntament amb un webhook status.updated (canvi d’estat) o data.updated (canvi en les coincidències).

Quan s’activa COULD_NOT_PERFORM_AML_SCREENING, la comprovació d’AML es manté a In Review fins que es proporcionin els camps d’identitat que falten. Un cop Didit té el nom complet, la data de naixement i l’estat emissor, l’AML es torna a executar automàticament i l’advertència s’elimina; no cal cap reactivació manual.

Exemples

`POSSIBLE_MATCH_FOUND` (puntuació per sobre del llindar d’aprovació)

{
  "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` (camps de KYC absents)

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

Relacionats

Informe d’AML — estructura completa de la resposta, camps de les coincidències, semàntica dels estats
Puntuació de risc AML — com es calcula la puntuació agregada
Puntuació de coincidència AML — confiança per coincidència
Monitoratge AML continu — cicle de vida del monitoratge
Models de dades: cribratge AML — esquema canònic, inclòs l’objecte d’advertència

Autenticació

Verificació

Monitoratge

Plataforma

Advertències de cribratge AML i codis d'alerta

Visió general

Advertències generades

Paràmetres configurables

Exemples

`POSSIBLE_MATCH_FOUND` (puntuació per sobre del llindar d’aprovació)

`COULD_NOT_PERFORM_AML_SCREENING` (camps de KYC absents)

Relacionats

Tipus d’advertències

​Visió general

​Advertències generades

​Paràmetres configurables

​Exemples

​POSSIBLE_MATCH_FOUND (puntuació per sobre del llindar d’aprovació)

​COULD_NOT_PERFORM_AML_SCREENING (camps de KYC absents)

​Relacionats

​Tipus d’advertències

Visió general

Advertències generades

Paràmetres configurables

Exemples

`POSSIBLE_MATCH_FOUND` (puntuació per sobre del llindar d’aprovació)

`COULD_NOT_PERFORM_AML_SCREENING` (camps de KYC absents)

Relacionats

Tipus d’advertències