Passer au contenu principal
GET
Obtenir une étape supplémentaire
L’authentification est une nouveauté. Ces endpoints sont fournis par l’émetteur de votre application, tel que https://<name>.auth.didit.me, et n’acceptent jamais votre clé API Didit.
Un step-up appartient à la session qui l’a créé : l’utilisation du token d’accès d’une autre session renvoie 404. Un step-up pending affiche expired une fois ses 30 minutes écoulées.

Autorisations

Authorization
string
header
requis

Le token d'accès de la personne issu de POST /token/ : un JWT ES256 avec l'en-tête typ: at+jwt, valide pendant au plus 5 minutes. Il ne s'agit pas de votre clé API Didit.

Paramètres de chemin

step_up_id
string<uuid>
requis

L'id provenant de POST /step-up/, également le paramètre de requête step_up sur votre return_to. Une valeur qui n'est pas un UUID renvoie une page 404, et non du JSON.

Réponse

Le step-up.

Une vérification que la personne doit réussir avant l'action.

id
string<uuid>
requis
Exemple:

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

rule
enum<string>
requis

La règle qui l'a demandée. Lorsque plusieurs s'appliquent, celle avec la méthode la plus forte.

Options disponibles:
payout,
device,
bank,
contact
Exemple:

"payout"

method
enum<string>
requis

Ce que la personne effectue : liveness, selfie (détection du vivant mise en correspondance avec le visage que Didit possède déjà) ou full_id (document et selfie). Lorsque Didit ne détient pas encore de visage pour la personne, selfie devient full_id dès qu'elle ouvre l'adresse verification_url.

Options disponibles:
liveness,
selfie,
full_id
Exemple:

"selfie"

status
enum<string>
requis

N'agissez que sur approved. review attend l'examen de votre équipe. declined n'est pas définitif tant que verification_url fonctionne : la personne peut réessayer, et la vérification renforcée repasse à pending. superseded signifie qu'une autre vérification a pris le relais, ou que le résultat ne concernait pas cette vérification renforcée : créez-en une nouvelle.

Options disponibles:
pending,
review,
approved,
declined,
expired,
superseded
Exemple:

"pending"

level
enum<string> | null
requis

Le niveau atteint par la vérification, une fois approuvée.

Options disponibles:
liveness,
liveness_face_match,
full_id,
null
Exemple:

null

amount
string | null
requis

Le montant du paiement, deux décimales.

Exemple:

"900.00"

currency
string | null
requis
Exemple:

"USD"

created_at
string<date-time>
requis
Exemple:

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

completed_at
string<date-time> | null
requis
Exemple:

null

expires_at
string<date-time>
requis

30 minutes après la création. La lecture d'un step-up collecte d'abord tout résultat atteint par sa vérification, de sorte qu'il peut toujours afficher approved, review ou declined après ce délai ; un step-up encore pending affiche expired.

Exemple:

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

Dernière modification le 7 novembre 2026