Zum Hauptinhalt springen
PATCH
curl
Um über einzelne Treffer statt über die gesamte Prüfung zu entscheiden, verwenden Sie AML-Trefferstatus aktualisieren. Informationen dazu, wie Screening-Ergebnisse und Status entstehen, finden Sie unter AML-Screening.

Autorisierungen

x-api-key
string
header
erforderlich

Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys.

Pfadparameter

sessionId
string<uuid>
erforderlich

UUID der Verifizierungssitzung (die von POST /v3/session/ zurückgegebene session_id). Akzeptiert Sitzungs-IDs sowohl für die Benutzerverifizierung (KYC) als auch für die Unternehmensverifizierung (KYB): Der Server löst die ID über beide Sitzungstypen hinweg auf. Muss eine wohlgeformte UUID sein; ein fehlerhafter Wert entspricht nicht der Route und gibt ein HTML-404 zurück.

Beispiel:

"11111111-2222-3333-4444-555555555555"

Abfrageparameter

node_id
string

Workflow-Graph-Knoten-ID der zu aktualisierenden AML-Prüfung. Nur erforderlich, wenn die Sitzung mehr als einen AML-Schritt durchlaufen hat. Hat Vorrang vor node_id im Body.

Beispiel:

"feature_aml_1"

Body

application/json
status
enum<string>
erforderlich

Neuer Status der AML-Prüfung.

Verfügbare Optionen:
Not Finished,
Approved,
Declined,
In Review,
Resub Requested
Beispiel:

"Approved"

node_id
string

Workflow-Graph-Knoten-ID der AML-Prüfung als Alternative zum Query-Parameter.

Beispiel:

"feature_aml_1"

Antwort

Status der AML-Prüfung gesetzt (oder unverändert, wenn er diesen Wert bereits hatte).

message
string
erforderlich

Immer AML status updated successfully.

status
enum<string>
erforderlich

Status der AML-Prüfung zum aktuellen Zeitpunkt.

Verfügbare Optionen:
Not Finished,
Approved,
Declined,
In Review,
Resub Requested
previous_status
enum<string>
erforderlich

Status vor dem Aufruf. Entspricht status, wenn sich nichts geändert hat.

Verfügbare Optionen:
Not Finished,
Approved,
Declined,
In Review,
Resub Requested
Zuletzt geändert am 7. November 2026