Unternehmensverifizierung (KYB): Vendor-CRUD-Operationen

Die gesamte Verwaltung von Unternehmen erfolgt über sechs öffentliche Endpoints unter /v3/businesses/. Diese Seite bietet einen konzeptionellen Überblick. Die vollständigen Schemas für Anfragen und Antworten finden Sie in der API-Referenz.

Unternehmen auflisten

GET /v3/businesses/ Paginierte Liste der Unternehmen für Ihre Anwendung mit Filtern für Status, Suchbegriff, Land und Datumsbereich.

curl -G https://verification.didit.me/v3/businesses/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "status=ACTIVE" \
  --data-urlencode "country_code=GBR" \
  --data-urlencode "page_size=50"

Ein Unternehmen abrufen

GET /v3/businesses/{vendor_data}/ Ruft ein einzelnes Unternehmen anhand von vendor_data ab.

curl https://verification.didit.me/v3/businesses/biz-acme/ \
  -H "x-api-key: YOUR_API_KEY"

Ein Unternehmen anlegen

POST /v3/businesses/create/ Legen Sie ein Unternehmen vorab an, bevor eine Sitzung der Unternehmensverifizierung (KYB) ausgeführt wird:

curl -X POST https://verification.didit.me/v3/businesses/create/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vendor_data": "biz-acme",
    "display_name": "Acme Corp",
    "country_code": "GBR",
    "metadata": { "partner": "Acme Holdings" }
  }'

Gibt einen Konfliktfehler zurück, wenn bereits ein Unternehmen mit diesem vendor_data existiert. Verwenden Sie PATCH, um ein bestehendes Unternehmen zu aktualisieren.

Ein Unternehmen aktualisieren

PATCH /v3/businesses/{vendor_data}/ Aktualisieren Sie änderbare Profilfelder. Felder, die aus Registerabfragen stammen (legal_name, registration_number, country_code), sind nach der Verifizierung schreibgeschützt, können aber überschrieben werden. Überschreibungen werden im Audit-Log markiert. Änderbare Felder: display_name, metadata, tags. Nach der Verifizierung schreibgeschützt: alle aus Registerdaten abgeleiteten Felder, Summenzähler, features-Map.

curl -X PATCH https://verification.didit.me/v3/businesses/biz-acme/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "metadata": { "tier": "enterprise" } }'

Löst business.data.updated aus.

Status ändern

PATCH /v3/businesses/{vendor_data}/update-status/ Verschieben Sie ein Unternehmen zwischen ACTIVE, FLAGGED und BLOCKED.

curl -X PATCH https://verification.didit.me/v3/businesses/biz-acme/update-status/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "BLOCKED",
    "reason": "Sanctioned subsidiary detected in ownership chain"
  }'

Von → nach	Häufiger Auslöser
`ACTIVE` → `FLAGGED`	Sitzung der Unternehmensverifizierung (KYB) wurde in `In Review` verschoben, laufender AML-Treffer, Transaktionsregel
`ACTIVE` → `BLOCKED`	Bestätigte sanktionierte Entität, manueller Eintrag in die Sperrliste
`FLAGGED` → `ACTIVE`	Analyst hat die Prüfung freigegeben
`BLOCKED` → `ACTIVE`	Manuelle Entsperrung nach Behebung

Löst business.status.updated aus.

Unternehmen löschen (Batch)

POST /v3/businesses/delete/ Löscht ein oder mehrere Unternehmen. Die Unternehmensdatensätze werden dauerhaft entfernt. Ihre Verifizierungssitzungen sind von diesem Endpoint nicht erfasst und bleiben erhalten, wobei ihre Verknüpfung mit dem Unternehmen entfernt wird. Löschen Sie diese mit Sitzung löschen. Transaktionen sind ebenfalls nicht erfasst. Löschen Sie diese über die Konsole.

curl -X POST https://verification.didit.me/v3/businesses/delete/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "vendor_data": ["biz-acme", "biz-alpha", "biz-beta"] }'

Idempotent: Das Löschen eines bereits gelöschten Unternehmens hat keine Wirkung.

Berechtigungsmodell

Alle Endpoints unter /v3/businesses/* werden über die Berechtigungsressource businesses gesteuert:

Rolle	list	get	create	update	update-status	delete
OWNER	✅	✅	✅	✅	✅	✅
ADMIN	✅	✅	✅	✅	✅	✅
COMPLIANCE_OFFICER	✅	✅	❌	✅	✅	❌
DEVELOPER	✅	✅	✅	❌	❌	❌
READER	✅	✅	❌	❌	❌	❌

Siehe Rollen und Berechtigungen.

Von diesen Vorgängen ausgelöste Webhooks

Operation	Webhook
`create`	`business.data.updated`
`update`	`business.data.updated` mit `changed_fields`
`update-status`	`business.status.updated`
`delete`	`business.data.updated` mit gesetztem `deleted_at`

Nächste Schritte

Datenmodell

Vollständige Feldreferenz.

List-API

Schema für GET /v3/businesses/.

Erstellungs-API

Schema für POST /v3/businesses/create/.

Übersicht

Preise

Workflows & Verifizierung

Prüfung & Betrieb

Entitäten (Benutzer & Unternehmen)

Einstellungen & Anpassung

Sicherheit & Compliance

Didit Academy

Ressourcen

Unternehmensverifizierung (KYB): Vendor-CRUD-Operationen

Unternehmen auflisten

Ein Unternehmen abrufen

Ein Unternehmen anlegen

Ein Unternehmen aktualisieren

Status ändern

Unternehmen löschen (Batch)

Berechtigungsmodell

Von diesen Vorgängen ausgelöste Webhooks

Nächste Schritte

Datenmodell

List-API

Erstellungs-API

​Unternehmen auflisten

​Ein Unternehmen abrufen

​Ein Unternehmen anlegen

​Ein Unternehmen aktualisieren

​Status ändern

​Unternehmen löschen (Batch)

​Berechtigungsmodell

​Von diesen Vorgängen ausgelöste Webhooks

​Nächste Schritte

Datenmodell

List-API

Erstellungs-API

Unternehmen auflisten

Ein Unternehmen abrufen

Ein Unternehmen anlegen

Ein Unternehmen aktualisieren

Status ändern

Unternehmen löschen (Batch)

Berechtigungsmodell

Von diesen Vorgängen ausgelöste Webhooks

Nächste Schritte