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 Update Status Hit AML: Konfirmasi & Tandai Kecocokan
Tandai hit skrining AML sebagai Kecocokan Terkonfirmasi, Positif Palsu, atau Tidak Meyakinkan, satu per satu atau massal, langsung dari API 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"
}Fungsi ini
Skrining AML menghasilkan daftar hit, yaitu kecocokan potensial dengan daftar sanksi, database PEP, daftar pantauan, dan media negatif. Setiap hit memilikireview_status (keputusannya) yang awalnya bernilai Unreviewed atau False Positive, bergantung pada skor kecocokan. Endpoint ini memungkinkan tim Anda (atau otomatisasi Anda) mencatat keputusan untuk setiap hit tanpa mengubah keputusan sesi secara keseluruhan.
Temukan hit beserta ID-nya di keputusan sesi, yaitu array hits pada pemeriksaan AML. Di sana, id setiap hit adalah hit_id yang Anda kirimkan ke endpoint ini.
Format id hit adalah hit_ diikuti 24 karakter heksadesimal, dan tetap sama saat subjek diskrining ulang. id hit dalam format sebelumnya masih diterima. Respons selalu menyebut hit dengan id terkini.
Status tinjauan
review_status | Arti |
|---|---|
Unreviewed | Nilai default untuk hit yang berada pada atau di atas ambang batas kecocokan. Hit ini masih memerlukan keputusan. |
Confirmed Match | Kecocokan sebenarnya untuk individu atau entitas yang diskrining. |
False Positive | Bukan entitas yang sama. Nilai default untuk hit yang berada di bawah ambang batas kecocokan. |
Inconclusive | Tidak dapat ditentukan. |
False Positive tetap memiliki status tersebut saat penyedia melakukan skrining ulang terhadap entitas.Perbarui satu hit
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 ke URL atau sertakan "node_id" di isi permintaan untuk menargetkan pemeriksaan tertentu.
Perbarui banyak hit sekaligus
PATCH /v3/session/{sessionId}/bulk-update-aml-hit-status/
Kirimkan hit_updates, yaitu daftar pasangan { hit_id, review_status }. Operasi ini bersifat semua atau tidak sama sekali: jika ada hit_id yang tidak ditemukan, permintaan mengembalikan 404 dan tidak ada hit yang diubah.
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 dan mencatat satu entri aktivitas yang mencakup semua perubahan.
Yang terjadi setelah pembaruan
- Webhook: event
data.updateddipicu pada sesi. - Jejak audit: perubahan dicatat pada jejak tinjauan sesi beserta pelakunya (kunci API atau pengguna), dan dapat dilihat di linimasa aktivitas konsol.
- Status langkah AML keseluruhan tidak berubah: mengubah keputusan sebuah hit tidak dengan sendirinya mengubah status langkah AML atau keputusan sesi. Untuk mengubah status langkah AML (
Approved/Declined/In Review), gunakan update-feature-status. Untuk mengubah keputusan sesi, gunakan update-status.
Dukungan KYC dan KYB
Endpoint ini berlaku untuk sesi Verifikasi Pengguna (KYC) dan Verifikasi Bisnis (KYB). Didit menemukansessionId di kedua jenis sesi tersebut. Untuk KYB, skrining AML dijalankan pada perusahaan dan pihak kunci, dan setiap pemeriksaan AML menampilkan hit masing-masing.
Izin
Memerlukan izinwrite:sessions, dengan kunci API klien (x-api-key) atau header otorisasi pengguna.
Kesalahan
| Status | Arti |
|---|---|
400 | review_status bukan nilai yang valid, hit_id kosong, atau hit_updates kosong. |
403 | Kredensial tidak ada atau tidak valid, atau pemanggil tidak memiliki izin write:sessions. |
404 | Sesi tidak ditemukan, sesi tidak memiliki pemeriksaan AML, atau hit_id tidak ditemukan (pada pembaruan massal: tidak ada yang diubah). |
Terkait
- Perbarui status fitur: mengubah status langkah AML (atau langkah lain mana pun).
- Perbarui status sesi: mengubah keputusan sesi secara keseluruhan.
- Ambil sesi: membaca
hitsAML beserta ID-nya. - Skrining AML: cara kerja skrining dan penilaian.
Otorisasi
Kunci API aplikasi Anda, dari Developers -> API keys di Business Console. Kunci utama memiliki akses penuh. Kunci bernama dapat diberi cakupan: none, read, atau write per sumber daya, dibatasi pada beberapa alur kerja atau pada sesi yang disetujui, pada daftar alamat IP, dan pada tanggal kedaluwarsa. 401 berarti kuncinya salah, dicabut, atau kedaluwarsa; 403 berarti tidak ada kunci yang dikirimkan, kunci tidak memiliki akses ke sumber daya atau tindakan ini, atau permintaan datang dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi berada di luar alur kerja atau status kunci tersebut. Kunci tanpa akses media menerima URL gambar, video, dan PDF sebagai null, dan kunci tanpa izin tulis sesi menerima tautan sesi dan token sebagai null. Lihat https://docs.didit.me/console/api-keys.
Parameter Path
UUID sesi verifikasi. Menerima ID sesi pengguna (KYC) dan bisnis (KYB) — layanan mencari ID tersebut di kedua jenis sesi.
"11111111-2222-3333-4444-555555555555"
Parameter Query
ID node graf alur kerja. Hanya diperlukan jika sesi memiliki beberapa pemeriksaan AML (satu per node); abaikan untuk sesi dengan AML tunggal.
"feature_aml_1"
Body
id dari hit dalam array hits pemeriksaan AML (hit_...). ID hit yang dikembalikan dalam format sebelumnya masih diterima.
"hit_7c1e9a40b2d35f86e0a4c912"
Status peninjauan baru untuk temuan tersebut.
Unreviewed, Confirmed Match, False Positive, Inconclusive "False Positive"
ID node graf opsional. Gunakan ID ini (di sini atau sebagai parameter kueri) saat sesi memiliki beberapa pemeriksaan AML.
"feature_aml_1"
Respons
Status peninjauan hit diperbarui.
Selalu Hit status updated successfully.
id dari hit yang diperbarui, sebagaimana dikembalikan oleh keputusan sesi, juga saat permintaan menyebutkan hit berdasarkan id dalam format sebelumnya.
Status peninjauan yang sekarang disimpan pada hasil kecocokan.
Unreviewed, Confirmed Match, False Positive, Inconclusive