Zum Hauptinhalt springen
PATCH
curl

Überblick

Verschiebt eine Unternehmens-Entität zwischen ACTIVE, FLAGGED und BLOCKED. Die vollständige Zustandslogik finden Sie unter Lebenszyklus der Entität.

Wann Sie es verwenden

  • Sperren Sie ein sanktioniertes oder nachweislich betrügerisches Unternehmen.
  • Markieren Sie ein Unternehmen, das auf eine manuelle Prüfung wartet.
  • Heben Sie die Blockierung auf, nachdem die Ursache behoben wurde.
  • Übernehmen Sie externe Signale aus Ihren eigenen Compliance-Systemen.

Hinweise

  • Gültige Werte: ACTIVE, FLAGGED, BLOCKED.
  • Übergeben Sie optional einen reason (bis zu 1000 Zeichen), um festzuhalten, warum sich der Status geändert hat. Didit speichert ihn im Eintrag zur Statusänderung in der Aktivität des Unternehmens in der Business Console. Er wird nur gespeichert, wenn sich der Status tatsächlich ändert.
  • Bei BLOCKED-Unternehmen werden alle neuen Sitzungen zur Unternehmensverifizierung (KYB) und alle neuen Transaktionen automatisch abgelehnt, auch wenn das Unternehmen als Gegenpartei auftritt.
  • Gibt business.status.updated mit previous_status und status aus. Der Webhook enthält kein reason.

Durchsetzung

Berechtigungen

Das primäre Secret und API-Schlüssel mit vollem Zugriff können diesen Endpoint immer aufrufen. Ein API-Schlüssel mit benutzerdefiniertem Zugriff benötigt die Schreibberechtigung für Unternehmen (businesses). Ein Schlüssel, der auf einzelne Workflows oder genehmigte Sitzungen beschränkt ist, kann diesen Endpoint nicht erreichen. Die Rollen und Berechtigungen der Business Console legen fest, was ein Teammitglied in der Console tun darf. Für Anfragen mit API-Schlüsseln werden sie nicht ausgewertet.

Verwandte Seiten

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

vendor_data
string
erforderlich

Ihre eindeutige Kennung für das Unternehmen (Freitext-String, KEINE UUID).

Body

application/json
status
enum<string>
erforderlich

Neuer Lebenszyklusstatus. BLOCKED fügt die vendor_data außerdem zur System-Sperrliste hinzu.

Verfügbare Optionen:
ACTIVE,
FLAGGED,
BLOCKED
reason
string | null

Warum sich der Status geändert hat. Wird im Statusänderungseintrag unter Activity des Unternehmens in der Business Console erfasst, nur wenn sich der Status tatsächlich ändert. Webhooks übertragen dies nicht.

Maximum string length: 1000

Antwort

Unternehmensstatus aktualisiert. Vollständiger Unternehmensdatensatz zurückgegeben.

Vollständige Unternehmensdetails. Erweitert BusinessListItem um Metadaten und updated_at.

didit_internal_id
string<uuid>

Didits stabile interne UUID für dieses Unternehmen.

vendor_data
string | null

Ihre eindeutige Kennung für dieses Unternehmen (beim Erstellen von Sitzungen übergeben). Dies kann null sein, wenn keine Vendor-Kennung angegeben wurde.

display_name
string | null

Von Ihnen festgelegter benutzerdefinierter Anzeigename

Offizieller juristischer Name aus dem Register oder manueller Eingabe

registration_number
string | null

Unternehmensregister- oder Gründungsnummer

country_code
string | null

Gründungsland (ISO 3166-1 Alpha-2, z. B. GB, US).

effective_name
string | null

Bester verfügbarer Name: display_name, falls gesetzt, andernfalls legal_name

status
enum<string>

Lebenszyklusstatus des Unternehmensdatensatzes (KEIN Sitzungsstatus). ACTIVE ist der Standard, FLAGGED markiert ihn für manuelle Prüfung, BLOCKED verhindert neue Sitzungen für dieses vendor_data.

Verfügbare Optionen:
ACTIVE,
FLAGGED,
BLOCKED
session_count
integer

Gesamtzahl der Verifizierungssitzungen für dieses Unternehmen

approved_count
integer

Anzahl der genehmigten Sitzungen

declined_count
integer

Anzahl der abgelehnten Sitzungen

in_review_count
integer

Anzahl der Sitzungen in Prüfung

features
object

Aggregierter Status pro Funktion über alle KYB-Sitzungen dieses Unternehmens hinweg. Derzeit ist der einzige Schlüssel KYB (der Status der Unternehmensprüfung im Register). Mögliche Werte: Approved, Declined, In Review, Not Finished, Resub Requested.

features_list
object[]

Dieselben Daten wie features, als geordnetes Array von {feature, status}-Objekten.

last_session_at
string<date-time> | null

Zeitstempel der letzten Sitzung

first_session_at
string<date-time> | null

Zeitstempel der ersten Sitzung

last_activity_at
string<date-time> | null

Zeitstempel der letzten Aktivität (Statusänderung, Sitzungsaktualisierung usw.)

tags
object[]

Diesem Unternehmen zugewiesene Tags

created_at
string<date-time>
metadata
object

Benutzerdefiniertes Metadaten-JSON, das Sie diesem Unternehmen angehängt haben. Standardmäßig {}.

updated_at
string<date-time>
Zuletzt geändert am 7. November 2026