curl -X PATCH \
https://verification.didit.me/v3/session/11111111-2222-3333-4444-555555555555/update-aml-hit-status/ \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"hit_id": "abc123",
"review_status": "False Positive"
}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.sessions.update_aml_hit_status(
"11111111-2222-3333-4444-555555555555",
hit_id="hit_7c1e9a40b2d35f86e0a4c912",
review_status="False Positive",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.sessions.updateAmlHitStatus("11111111-2222-3333-4444-555555555555", {
hit_id: "hit_7c1e9a40b2d35f86e0a4c912",
review_status: "False Positive",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Sessions.UpdateAMLHitStatus(ctx, "11111111-2222-3333-4444-555555555555", didit.SessionsUpdateAMLHitStatusParams{
HitID: "hit_7c1e9a40b2d35f86e0a4c912",
ReviewStatus: "False Positive",
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.SessionsUpdateAmlHitStatusParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.sessions().updateAmlHitStatus("11111111-2222-3333-4444-555555555555", SessionsUpdateAmlHitStatusParams.builder()
.hitId("hit_7c1e9a40b2d35f86e0a4c912")
.reviewStatus(SessionsUpdateAmlHitStatusParams.ReviewStatus.of("False Positive"))
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->sessions->updateAmlHitStatus('11111111-2222-3333-4444-555555555555', [
'hit_id' => 'hit_7c1e9a40b2d35f86e0a4c912',
'review_status' => 'False Positive',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.sessions.update_aml_hit_status(
"11111111-2222-3333-4444-555555555555",
hit_id: "hit_7c1e9a40b2d35f86e0a4c912",
review_status: "False Positive"
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Sessions.UpdateAmlHitStatusAsync("11111111-2222-3333-4444-555555555555", new SessionsUpdateAmlHitStatusParams
{
HitId = "hit_7c1e9a40b2d35f86e0a4c912",
ReviewStatus = "False Positive",
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"message": "Hit status updated successfully",
"hit_id": "hit_7c1e9a40b2d35f86e0a4c912",
"review_status": "False Positive"
}API d'estat de coincidències AML: Actualitzar i confirmar
Marca coincidències del cribratge AML com a Coincidència confirmada, Fals positiu o No concloent, individualment o en lot, directament des de l’API de Didit.
curl -X PATCH \
https://verification.didit.me/v3/session/11111111-2222-3333-4444-555555555555/update-aml-hit-status/ \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"hit_id": "abc123",
"review_status": "False Positive"
}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.sessions.update_aml_hit_status(
"11111111-2222-3333-4444-555555555555",
hit_id="hit_7c1e9a40b2d35f86e0a4c912",
review_status="False Positive",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.sessions.updateAmlHitStatus("11111111-2222-3333-4444-555555555555", {
hit_id: "hit_7c1e9a40b2d35f86e0a4c912",
review_status: "False Positive",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Sessions.UpdateAMLHitStatus(ctx, "11111111-2222-3333-4444-555555555555", didit.SessionsUpdateAMLHitStatusParams{
HitID: "hit_7c1e9a40b2d35f86e0a4c912",
ReviewStatus: "False Positive",
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.SessionsUpdateAmlHitStatusParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.sessions().updateAmlHitStatus("11111111-2222-3333-4444-555555555555", SessionsUpdateAmlHitStatusParams.builder()
.hitId("hit_7c1e9a40b2d35f86e0a4c912")
.reviewStatus(SessionsUpdateAmlHitStatusParams.ReviewStatus.of("False Positive"))
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->sessions->updateAmlHitStatus('11111111-2222-3333-4444-555555555555', [
'hit_id' => 'hit_7c1e9a40b2d35f86e0a4c912',
'review_status' => 'False Positive',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.sessions.update_aml_hit_status(
"11111111-2222-3333-4444-555555555555",
hit_id: "hit_7c1e9a40b2d35f86e0a4c912",
review_status: "False Positive"
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Sessions.UpdateAmlHitStatusAsync("11111111-2222-3333-4444-555555555555", new SessionsUpdateAmlHitStatusParams
{
HitId = "hit_7c1e9a40b2d35f86e0a4c912",
ReviewStatus = "False Positive",
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"message": "Hit status updated successfully",
"hit_id": "hit_7c1e9a40b2d35f86e0a4c912",
"review_status": "False Positive"
}Què fa aquest endpoint
El cribratge AML retorna una llista de coincidències: possibles coincidències amb llistes de sancions, bases de dades de PEP, llistes de vigilància i mitjans adversos. Cada coincidència té unreview_status (la seva disposició), que comença com a Unreviewed o False Positive segons la puntuació de coincidència. Aquest endpoint permet a l’equip (o a l’automatització) registrar una decisió sobre cada coincidència, sense canviar la decisió global de la sessió.
Trobeu les coincidències i els seus IDs a la decisió de la sessió: l’array hits de la comprovació AML, on l’id de cada coincidència és el hit_id que hi passeu.
Un id de coincidència té el format hit_ seguit de 24 caràcters hexadecimals, i es manté igual quan el subjecte es torna a cribrar. Un id de coincidència en el format anterior encara s’accepta; la resposta sempre identifica la coincidència pel seu id actual.
Estats de revisió
review_status | Significat |
|---|---|
Unreviewed | Valor per defecte per a les coincidències iguals o superiors al llindar de coincidència. Encara necessita una decisió. |
Confirmed Match | Una coincidència real amb la persona o entitat cribrada. |
False Positive | No és la mateixa entitat. Valor per defecte per a les coincidències inferiors al llindar de coincidència. |
Inconclusive | No s’ha pogut determinar. |
False Positive manté aquest estat quan el proveïdor torna a cribrar l’entitat.Actualitzar una sola coincidència
PATCH /v3/session/{sessionId}/update-aml-hit-status/
curl -X PATCH https://verification.didit.me/v3/session/4c5c7f3a-.../update-aml-hit-status/ \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"hit_id": "hit_7c1e9a40b2d35f86e0a4c912",
"review_status": "False Positive"
}'
?node_id=feature_aml_1 a la URL o inclogueu "node_id" al cos de la petició per apuntar a una comprovació concreta.
Actualitzar moltes coincidències alhora
PATCH /v3/session/{sessionId}/bulk-update-aml-hit-status/
Passeu hit_updates, una llista de parells { hit_id, review_status }. L’operació és tot o res: si no es troba algun hit_id, la petició retorna 404 i no es canvia cap coincidència.
curl -X PATCH https://verification.didit.me/v3/session/4c5c7f3a-.../bulk-update-aml-hit-status/ \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"hit_updates": [
{ "hit_id": "hit_7c1e9a40b2d35f86e0a4c912", "review_status": "Confirmed Match" },
{ "hit_id": "hit_3b8f20d6a91c4e75f0b2d6a8", "review_status": "False Positive" }
]
}'
data.updated i registra una entrada d’activitat que cobreix tots els canvis.
Què passa després d’una actualització
- Webhook: es dispara un esdeveniment
data.updateda la sessió. - Registre d’auditoria: el canvi es registra al registre de revisió de la sessió amb l’actor (clau d’API o usuari), i és visible a la cronologia d’activitat de la consola.
- L’estat general del pas AML no es modifica: canviar la disposició d’una coincidència no canvia, per si sol, l’estat del pas AML ni la decisió de la sessió. Per canviar l’estat del pas AML (
Approved/Declined/In Review), useu update-feature-status. Per canviar la decisió de la sessió, useu update-status.
Compatibilitat amb KYC i KYB
Funciona tant per a sessions de Verificació d’usuaris (KYC) com per a sessions de Verificació d’empreses (KYB): Didit resol elsessionId en tots dos casos. En el cas de KYB, el cribratge AML s’aplica a l’empresa i a les seves persones clau, i cada comprovació AML exposa les seves pròpies coincidències.
Permís
Cal el privilegiwrite:sessions, amb una clau d’API de client (x-api-key) o amb una capçalera d’autorització d’usuari.
Errors
| Estat | Significat |
|---|---|
400 | review_status no és un valor vàlid, hit_id és buit o hit_updates és buit. |
403 | Credencials absents o no vàlides, o el sol·licitant no té write:sessions. |
404 | Sessió no trobada, la sessió no té cap comprovació AML, o no s’ha trobat un hit_id (en el cas massiu, no es canvia res). |
Relacionat
- Actualitzar l’estat de la funcionalitat: canvia l’estat del pas AML (o de qualsevol altre pas).
- Actualitzar l’estat de la sessió: canvia la decisió global de la sessió.
- Recuperar la sessió: llegeix els
hitsd’AML i els seus IDs. - Cribratge AML: com funcionen el cribratge i la puntuació.
Autoritzacions
La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys.
Paràmetres de ruta
UUID de la sessió de verificació. Accepta tant IDs de sessió d'usuari (KYC) com d'empresa (KYB); el servei resol l'ID entre tots dos tipus de sessió.
"11111111-2222-3333-4444-555555555555"
Paràmetres de consulta
ID del node del graf del flux de treball. Només és obligatori quan la sessió té múltiples comprovacions AML (una per node); omet-ho per a sessions amb un sol AML.
"feature_aml_1"
Cos
L'id de la coincidència a la matriu hits del cribratge AML (hit_...). Encara s'accepta un id de coincidència retornat en el format anterior.
"hit_7c1e9a40b2d35f86e0a4c912"
El nou estat de revisió per a la coincidència.
Unreviewed, Confirmed Match, False Positive, Inconclusive "False Positive"
ID opcional del node del graf. Utilitza'l (aquí o com a paràmetre de consulta) quan la sessió tingui múltiples comprovacions d'AML.
"feature_aml_1"
Resposta
Estat de revisió de la coincidència actualitzat.
Sempre Hit status updated successfully.
L'id de la coincidència actualitzada, tal com el retorna la decisió de la sessió, també quan la sol·licitud ha identificat la coincidència mitjançant un id en el format anterior.
L'estat de revisió emmagatzemat actualment a la coincidència.
Unreviewed, Confirmed Match, False Positive, Inconclusive