Zum Hauptinhalt springen
GET
Höhere Verifizierungsstufe abrufen
Die Authentifizierung ist neu. Diese Endpoints werden vom Aussteller Ihrer Anwendung bereitgestellt, etwa https://<name>.auth.didit.me, und akzeptieren niemals Ihren API-Schlüssel für Didit.
Ein Step-up gehört zu der Sitzung, die ihn erstellt hat. Das Access-Token einer anderen Sitzung erhält eine 404-Antwort. Ein Step-up im Status pending gibt nach Ablauf seiner 30 Minuten den Status expired zurück.

Autorisierungen

Authorization
string
header
erforderlich

Das Access Token der Person von POST /token/: ein ES256-JWT mit dem Header typ: at+jwt, gültig für maximal 5 Minuten. Nicht Ihr Didit-API-Schlüssel.

Pfadparameter

step_up_id
string<uuid>
erforderlich

Die id von POST /step-up/, außerdem der Abfrageparameter step_up auf Ihrer return_to. Ein Wert, der keine UUID ist, führt zu einer 404-Seite, kein JSON.

Antwort

Das Step-up.

Eine Verifizierung, die die Person vor der Aktion bestehen muss.

id
string<uuid>
erforderlich
Beispiel:

"94efc2c3-ca84-42fe-900b-6fb61669a7a1"

rule
enum<string>
erforderlich

Die Regel, die dies angefordert hat. Wenn mehrere zutreffen, diejenige mit der stärksten Methode.

Verfügbare Optionen:
payout,
device,
bank,
contact
Beispiel:

"payout"

method
enum<string>
erforderlich

Was die Person tut: liveness, selfie (Liveness-Abgleich mit dem Gesicht, das Didit bereits vorliegen hat) oder full_id (Dokument und Selfie). Wenn Didit noch kein Gesicht für die Person vorliegen hat, wird selfie zu full_id, sobald die Person die verification_url öffnet.

Verfügbare Optionen:
liveness,
selfie,
full_id
Beispiel:

"selfie"

status
enum<string>
erforderlich

Reagieren Sie nur auf approved. review wartet auf die Überprüfung durch Ihr Team. declined ist nicht endgültig, solange die verification_url funktioniert: Die Person kann es erneut versuchen, und das Step-up wechselt wieder zu pending. superseded bedeutet, dass eine andere Prüfung die Verifizierung übernommen hat oder das Ergebnis nicht zu diesem Step-up gehörte: Erstellen Sie ein neues.

Verfügbare Optionen:
pending,
review,
approved,
declined,
expired,
superseded
Beispiel:

"pending"

level
enum<string> | null
erforderlich

Die Stufe, die die Verifizierung nach der Genehmigung erreicht hat.

Verfügbare Optionen:
liveness,
liveness_face_match,
full_id,
null
Beispiel:

null

amount
string | null
erforderlich

Der Auszahlungsbetrag, zwei Dezimalstellen.

Beispiel:

"900.00"

currency
string | null
erforderlich
Beispiel:

"USD"

created_at
string<date-time>
erforderlich
Beispiel:

"2026-10-17T10:41:14.894632Z"

completed_at
string<date-time> | null
erforderlich
Beispiel:

null

expires_at
string<date-time>
erforderlich

30 Minuten nach der Erstellung. Beim Auslesen einer Step-up-Prüfung wird zunächst jedes Ergebnis erfasst, das die Verifizierung erreicht hat, sodass danach weiterhin approved, review oder declined angezeigt werden kann; eine Prüfung, die noch pending ist, wird als expired angezeigt.

Beispiel:

"2026-10-17T11:11:14.894581Z"

Zuletzt geändert am 7. November 2026