Saltar al contingut principal
GET
Obtenir un augment de nivell
L’autenticació és nova. Aquests endpoints els serveix l’emissor de la teva aplicació, com ara https://<name>.auth.didit.me, i mai no reben la teva clau d’API de Didit.
Un step-up pertany a la sessió que l’ha creat: el token d’accés d’una altra sessió rep 404. Un step-up en estat pending retorna expired quan hagin passat 30 minuts.

Autoritzacions

Authorization
string
header
requerit

El token d'accés de la persona procedent de POST /token/: un JWT ES256 amb la capçalera typ: at+jwt, vàlid durant un màxim de 5 minuts. No és la teva clau d'API de Didit.

Paràmetres de ruta

step_up_id
string<uuid>
requerit

L'id de POST /step-up/, també el paràmetre de consulta step_up al teu return_to. Un valor que no sigui un UUID rep una pàgina 404, no JSON.

Resposta

L'step-up.

Una verificació que la persona ha de superar abans de l'acció.

id
string<uuid>
requerit
Exemple:

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

rule
enum<string>
requerit

La regla que ho ha sol·licitat. Quan se n'apliquen diverses, la que té el mètode més fort.

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

"payout"

method
enum<string>
requerit

El que fa la persona: liveness, selfie (prova de vida comparada amb la cara que Didit ja té) o full_id (document i selfie). Quan Didit encara no té cap cara associada a la persona, selfie passa a ser full_id un cop obre la verification_url.

Opcions disponibles:
liveness,
selfie,
full_id
Exemple:

"selfie"

status
enum<string>
requerit

Actua només sobre approved. review espera la revisió del teu equip. declined no és definitiu mentre verification_url funcioni: la persona pot tornar-ho a provar, i el pas addicional torna a pending. superseded significa que una altra comprovació ha assumit la seva verificació, o que el resultat no era per a aquest pas addicional: crea'n un de nou.

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

"pending"

level
enum<string> | null
requerit

El nivell que ha assolit la verificació, un cop aprovada.

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

null

amount
string | null
requerit

L'import del pagament, amb dos decimals.

Exemple:

"900.00"

currency
string | null
requerit
Exemple:

"USD"

created_at
string<date-time>
requerit
Exemple:

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

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

null

expires_at
string<date-time>
requerit

30 minuts després de la creació. En consultar un pas d'escalat (step-up), primer es recopila qualsevol resultat que hagi assolit la seva verificació, de manera que encara pot mostrar approved, review o declined després d'aquest temps; un que encara estigui en estat pending mostrarà expired.

Exemple:

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

Darrera modificació el 7 de novembre del 2026