Zum Hauptinhalt springen
POST
curl

Überblick

Aktiviert oder deaktiviert die laufende AML-Überwachung für die ausgewählten Unternehmen, genau wie die Aktion Laufende AML-Überwachung in der Business Console. Die Console und dieser Endpoint führen denselben zugrunde liegenden Vorgang aus, daher sind die Regeln, die Abrechnung und die Ergebnisse identisch. Senden Sie zuerst estimate_only: true, um zu sehen, wie viele Unternehmen ausgewählt sind, wie viele ein neues AML-Screening benötigen, die einmalige Screening-Gebühr und die jährlichen Überwachungskosten. Ein Testlauf (Dry-Run) schreibt nichts. Die Schätzung verwendet dieselben Feldnamen wie der Users-Endpoint, daher ist users_total die Anzahl der ausgewählten Unternehmen.

So wird eine Auswahl verarbeitet

  • Ein überwachtes Screening pro Unternehmen. Ein Unternehmen, das sich mehrfach verifiziert hat, wird nur einmal überwacht und einmal abgerechnet. Die Deaktivierung schaltet die Überwachung für alle Screenings dieses Unternehmens ab.
  • Unternehmen ohne AML-Screening werden zuerst gescreent. Didit erstellt für sie eine neue AML-Verifizierung (sichtbar im Tab Verifizierungen des Unternehmens), die wie ein reguläres AML-Screening abgerechnet wird, und aktiviert darauf die Überwachung. Das Screening verwendet den rechtlichen Namen (oder den Anzeigenamen) und das Land des Unternehmens. Ein Unternehmen ganz ohne Namen wird als skipped_no_identity_data gemeldet und nicht stillschweigend verworfen.
  • Sandbox-Anwendungen erstellen nie Screenings (skipped_sandbox).
  • Das Guthaben wird vorab geprüft. Die Aktivierung wird mit 403 abgelehnt, wenn Ihr Guthaben die Schätzung nicht deckt. Die Antwort enthält die Schätzung, damit Sie wissen, wie viel Sie aufladen müssen.
  • Jährliche Verlängerung. Ein neu überwachtes Unternehmen wird zum Preis für die jährliche Überwachung am nächsten Verlängerungsdatum abgerechnet, also zu dem Datum, das die Console in der Spalte Laufende Überwachung anzeigt. Die Deaktivierung stoppt die Verlängerung, erstattet aber keinen bereits abgerechneten Zeitraum.

Auswahl und Batch-Größe

Wählen Sie Unternehmen über vendor_data_list, didit_internal_id_list oder beide aus. Die beiden Listen werden mit ODER verknüpft. Eine Anfrage akzeptiert insgesamt höchstens 1000 Identifikatoren über beide Listen. Identifikatoren, die keinem Unternehmen in Ihrer Anwendung entsprechen, werden unverändert unter unmatched zurückgegeben und lassen die Anfrage nie fehlschlagen. Eine Auswahl ohne Treffer wird als leerer Job abgeschlossen (total: 0), wobei alle Identifikatoren aufgelistet werden, wie bei den Batch-Lösch-Endpoints.

Inline oder im Hintergrund

Auswahlen mit höchstens 20 Unternehmen werden inline verarbeitet, und der Aufruf gibt 200 mit dem abgeschlossenen Job zurück. Größere Auswahlen geben 202 mit einem Job im Status PENDING zurück. Fragen Sie AML-Monitoring-Job abrufen ab, bis status COMPLETED oder FAILED ist. In beiden Fällen enthält der Job pro Unternehmen einen Eintrag in results mit dessen outcome.

Webhooks

Das Umschalten der Überwachung sendet keinen eigenen Webhook. Sobald die Überwachung aktiv ist, lösen erneute Screenings weiterhin die üblichen Ereignisse status.updated und data.updated aus, die unter Laufende AML-Überwachung beschrieben sind.

Berechtigungen

Jeder aktive API-Schlüssel der Anwendung kann diesen Endpoint aufrufen. Didit-API-Schlüssel sind anwendungsbezogen, nicht rollenbezogen. Die Rollen und Berechtigungen der Console legen fest, was eine Person in der Console tun darf, und werden für Datenverkehr der Management API nicht ausgewertet.

Verwandte Themen

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.

Body

application/json

Wählen Sie Unternehmen mit vendor_data_list, didit_internal_id_list oder beiden aus (die beiden Listen werden ODER-verknüpft). Maximal 1000 IDs pro Anfrage über beide Listen hinweg.

is_enabled
boolean
erforderlich

true, um die Überwachung zu aktivieren, false, um sie zu deaktivieren.

estimate_only
boolean
Standard:false

Wenn true, wird die Kostenschätzung zurückgegeben und es werden keine Schreibvorgänge ausgeführt – kein Screening, keine Abrechnung, kein Job.

vendor_data_list
string[]

Ihre eigenen Kennungen der umzuschaltenden Unternehmen, exakt so abgeglichen wie übermittelt.

didit_internal_id_list
string<uuid>[]

Interne Didit-IDs der umzuschaltenden Unternehmen – die von den Create-, Get- und List-Endpoints zurückgegebene didit_internal_id.

Antwort

Die Schätzung (wenn estimate_only true ist) oder der abgeschlossene Job für eine inline verarbeitete Auswahl.

Kostenvorschau. Wird direkt zurückgegeben, wenn estimate_only wahr ist (es wird nichts geschrieben).

users_total
integer
erforderlich

Profile, die der Auswahl entsprechen.

already_enabled
integer
erforderlich

Profile, die bereits überwacht werden (beim Aktivieren ist nichts zu tun; diese werden beim Deaktivieren abgeschaltet).

with_existing_aml
integer
erforderlich

Profile, deren bestehendes AML-Screening auf überwacht umgestellt wird (kein neues Screening).

needing_screening
integer
erforderlich

Profile ohne bisheriges AML-Screening, die zuerst gescreent werden (abgerechnet als reguläres AML-Screening).

skipped_no_identity_data
integer
erforderlich

Profile, die nicht gescreent werden können, da Identitätsdaten fehlen.

skipped_blocked
integer
erforderlich

Gesperrte Benutzer, die übersprungen werden (bei Unternehmen immer 0).

estimated_screening_cost_usd
number
erforderlich

Einmalige Kosten für die neuen Screenings.

Beispiel:

0.2

estimated_annual_monitoring_cost_usd
number
erforderlich

Jährliche Überwachungskosten für die Profile, die künftig überwacht werden.

Beispiel:

0.07

balance_sufficient
boolean
erforderlich

Gibt an, ob das Guthaben der Organisation das Screening plus das erste Jahr der Überwachung abdeckt.

unmatched
string[]
erforderlich

Kennungen der Anfrage, die mit keinem Profil in dieser Anwendung übereinstimmten, exakt wie gesendet.

Zuletzt geändert am 7. November 2026