Zum Hauptinhalt springen
POST
curl

Unterstützung für KYC und KYB

Funktioniert sowohl für Sitzungen zur Benutzerverifizierung (KYC) als auch zur Unternehmensverifizierung (KYB). Didit gleicht die session_id mit beiden Sitzungstypen ab und erzeugt ein JWT-Freigabe-Token, das Folgendes enthält:
Wenn der empfangende Partner das Token importiert, klont Didit die entsprechende Sitzungsart (KYC oder KYB) samt ihrer Beziehungen.

Anforderungen

  • Die Sitzung muss einen abgeschlossenen Status haben (APPROVED, DECLINED, IN_REVIEW).
  • Sie müssen über die Berechtigung write:sessions verfügen.
  • Die for_application_id muss eine gültige Didit-Anwendung sein (in der Regel die Anwendung eines Partners).

Beispiele

Antwort:

TTL-Grenzen

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.

Pfadparameter

sessionId
string<uuid>
erforderlich

UUID der Quell-Verifizierungssitzung, für die ein Token ausgestellt werden soll.

Beispiel:

"11111111-2222-3333-4444-555555555555"

Body

application/json
for_application_id
string<uuid>
erforderlich

UUID der Didit-Anwendung, die das Token einlösen wird. Muss existieren, darf nicht gelöscht sein und muss sich von der aufrufenden Anwendung unterscheiden. Sie finden sie in der Business Console unter Settings → Application.

Beispiel:

"a5f3bca2-46e2-411e-90ef-a580900a57ee"

ttl_in_seconds
integer
Standard:3600

Token-Lebensdauer in Sekunden. Minimum 60, Maximum 86400 (24 Std.). Standardmäßig 3600 (1 Std.).

Erforderlicher Bereich: 60 <= x <= 86400
Beispiel:

3600

Antwort

Share-Token erstellt.

share_token
string

HS256-signiertes JWT. Übergeben Sie dies unverändert als share_token an POST /v3/session/import-shared/ in der Zielanwendung.

Beispiel:

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

for_application_id
string<uuid>

Gibt die Ziel-Anwendungs-UUID wieder, an die das Token gebunden ist.

Beispiel:

"a5f3bca2-46e2-411e-90ef-a580900a57ee"

session_kind
enum<string>

Gibt an, ob die Quellsitzung eine Sitzung der Benutzerverifizierung (KYC) oder der Unternehmensverifizierung (KYB) ist.

Verfügbare Optionen:
user,
business
Zuletzt geändert am 7. November 2026