Zum Hauptinhalt springen
POST
curl
Verwenden Sie diese Anleitung, wenn der vorherige Link nicht mehr funktioniert: Die Sitzung wurde gelöscht oder ist abgelaufen, bevor die Person sie gestartet hat. Gelöschte Sitzungen qualifizieren sich auch dann, wenn die Person die Verifizierung bereits begonnen oder abgeschlossen hatte. Importierte Sitzungen qualifizieren sich nicht aufgrund des Ablaufs; sie müssen gelöscht worden sein. Eine Sitzung, die nicht gelöscht wurde und die die Person bereits gestartet hatte, qualifiziert sich nicht aufgrund des Ablaufs. Die neue Sitzung ist mit derselben Partei verknüpft, sodass ihr Ergebnis wie das Ergebnis der ursprünglichen Sitzung in die Prüfung der Schlüsselpersonen einfließt. Der Link ist für die Sitzungsdauer des KYC-Workflows gültig, den die neue Sitzung ausführt (1 Stunde bis 4 Wochen), nicht für die der Unternehmenssitzung geltende Dauer. Lesen Sie die Partei und ihre untergeordneten Sitzungen in der Entscheidung zur Unternehmenssitzung. Wenn die Person überhaupt nicht verifiziert werden soll, überspringen Sie stattdessen die Partei. Informationen dazu, wie Parteien und ihre Verifizierungen funktionieren, finden Sie unter Schlüsselpersonen.

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 übergeordneten Sitzung zur Unternehmensverifizierung (KYB).

Beispiel:

"33333333-4444-5555-6666-777777777777"

partyUuid
string<uuid>
erforderlich

UUID der Partei der Schlüsselpersonen (key_people_checks[].submitted.parties[].uuid in der Entscheidung der Unternehmenssitzung). Muss zu der durch sessionId referenzierten Sitzung gehören.

Beispiel:

"0a3f1e2c-7c2f-4a1b-9d55-2f8d2a5d6b41"

Antwort

Neue KYC-Sitzung erstellt. Gibt die aktualisierte Partei mit ihrer neuen untergeordneten Sitzung zurück, die nach Ablauf der Sitzungsdauer ihres KYC-Workflows abläuft.

Eine Partei aus den Schlüsselpersonen einer Sitzung zur Unternehmensverifizierung (KYB) mit ihrer untergeordneten Verifizierung. Dieselbe Partei erscheint in key_people_checks[].submitted.parties[] der Entscheidung zur Unternehmenssitzung.

uuid
string<uuid>
erforderlich

Parteien-ID.

entity_type
enum<string>
erforderlich

Gibt an, ob die Partei eine Einzelperson oder ein Unternehmen ist.

Verfügbare Optionen:
person,
company
source
enum<string>
erforderlich

REGISTRY: Aus dem Unternehmensregister übernommen. USER: Im Bildschirm „Schlüsselpersonen“ eingegeben.

Verfügbare Optionen:
REGISTRY,
USER
name
string
erforderlich

Anzeigename der Partei.

is_active
boolean
erforderlich

Gibt an, ob die Partei aktiv ist.

is_skipped
boolean
erforderlich

Gibt an, ob die Partei von der Verifizierung ausgenommen ist. Ein erneutes Generieren hebt dies auf.

requires_verification
boolean
erforderlich

Gibt an, ob die Rollen- und Eigentümerstruktur-Regeln eine Verifizierung für diese Partei vorschreiben.

roles
object[]
erforderlich

Rollen, die die Partei im Unternehmen innehat.

kyc_session_deleted
boolean
erforderlich

Die untergeordnete KYC-Sitzung wurde gelöscht, sodass sie niemals abgeschlossen werden kann.

kyb_sub_session_deleted
boolean
erforderlich

Unternehmensbezogenes Gegenstück zu kyc_session_deleted.

first_name
string | null

Vorname (Personen).

last_name
string | null

Nachname (Personen).

company_name
string | null

Unternehmensname (Unternehmensparteien).

registration_number
string | null

Unternehmensregisternummer (Unternehmensparteien).

email
string<email> | null

E-Mail-Adresse, an die der Verifizierungslink gesendet wird.

nationality
string | null

Staatsangehörigkeit für Personen, Gründungsland für Unternehmen.

phone_number
string | null

Für die Partei erfasste Telefonnummer.

date_of_birth
string<date> | null

Geburtsdatum (Personen).

position
string | null

Freitext-Berufsbezeichnung (Personen).

custom_fields
object

Vom Workflow definierte benutzerdefinierte Felder, die für die Partei erfasst wurden, indiziert nach Feldschlüssel.

kyc_session_id
string<uuid> | null

Untergeordnete individuelle KYC-Sitzung (Personen).

kyc_session_status
enum<string> | null

Status der untergeordneten KYC-Sitzung. Eine gelöschte Sitzung behält den Status, den sie zum Zeitpunkt der Löschung hatte.

Verfügbare Optionen:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User,
null
kyc_session_url
string<uri> | null

Gehosteter Link der untergeordneten KYC-Sitzung. null, wenn keine vorhanden ist oder sie gelöscht wurde, sowie bei einem berechtigungseingeschränkten API-Schlüssel ohne sessions: write.

kyb_sub_session_id
string<uuid> | null

Untergeordnete KYB-Sitzung (Unternehmensparteien).

kyb_sub_session_status
enum<string> | null

Status der untergeordneten KYB-Sitzung.

Verfügbare Optionen:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User,
null
kyb_sub_session_url
string<uri> | null

Gehosteter Link der untergeordneten KYB-Sitzung, mit denselben null-Regeln wie bei kyc_session_url.

verification_workflow_type
enum<string> | null

Typ des Workflows, den die untergeordnete Sitzung ausführt.

Verfügbare Optionen:
kyc,
kyb,
adaptive_age_verification,
biometric_authentication,
address_verification,
questionnaire_verification,
email_verification,
phone_verification,
null
verification_workflow_id
string<uuid> | null

Workflow, den die untergeordnete Sitzung ausführt.

verification_workflow_label
string | null

Bezeichnung dieses Workflows.

verification_workflow_features
object[] | null

Funktionen des Workflows der untergeordneten Sitzung mit ihrem aktuellen Status.

didit_internal_id
string<uuid> | null

Didits Kennung der verifizierten Person, sobald bekannt.

Zuletzt geändert am 7. November 2026