Saltar al contenido principal
GET
Obtener un step-up
Authentication es una función nueva. Estos endpoints los sirve el emisor de tu aplicación, como https://<name>.auth.didit.me, y nunca aceptan tu clave de API de Didit.
Un step-up pertenece a la sesión que lo creó: el token de acceso de otra sesión obtiene un 404. Un step-up pending aparece como expired una vez transcurridos sus 30 minutos.

Autorizaciones

Authorization
string
header
requerido

El token de acceso de la persona obtenido de POST /token/: un JWT ES256 con el encabezado typ: at+jwt, válido durante un máximo de 5 minutos. No es tu clave de API de Didit.

Parámetros de ruta

step_up_id
string<uuid>
requerido

El id de POST /step-up/, que también es el parámetro de consulta step_up en tu return_to. Un valor que no es un UUID obtiene una página 404, no JSON.

Respuesta

El step-up.

Una verificación que la persona tiene que superar antes de la acción.

id
string<uuid>
requerido
Ejemplo:

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

rule
enum<string>
requerido

La regla que lo solicitó. Cuando se aplican varias, la que tiene el método más robusto.

Opciones disponibles:
payout,
device,
bank,
contact
Ejemplo:

"payout"

method
enum<string>
requerido

Lo que hace la persona: liveness, selfie (prueba de vida comparada con el rostro que Didit ya tiene) o full_id (documento y selfie). Si Didit aún no tiene ningún rostro de la persona, selfie pasa a ser full_id en cuanto abre verification_url.

Opciones disponibles:
liveness,
selfie,
full_id
Ejemplo:

"selfie"

status
enum<string>
requerido

Actúa solo ante approved. review espera la revisión de tu equipo. declined no es definitivo mientras verification_url funcione: la persona puede volver a intentarlo y la verificación adicional vuelve a pending. superseded significa que otra comprobación asumió su verificación, o que el resultado no correspondía a esta verificación adicional: crea una nueva.

Opciones disponibles:
pending,
review,
approved,
declined,
expired,
superseded
Ejemplo:

"pending"

level
enum<string> | null
requerido

El nivel que alcanzó la verificación, una vez aprobada.

Opciones disponibles:
liveness,
liveness_face_match,
full_id,
null
Ejemplo:

null

amount
string | null
requerido

El importe del pago, con dos decimales.

Ejemplo:

"900.00"

currency
string | null
requerido
Ejemplo:

"USD"

created_at
string<date-time>
requerido
Ejemplo:

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

completed_at
string<date-time> | null
requerido
Ejemplo:

null

expires_at
string<date-time>
requerido

30 minutos después de la creación. Al leer una verificación step-up, primero se recopila cualquier resultado que haya alcanzado su verificación, por lo que todavía puede mostrar approved, review o declined después de ese momento; una que siga en pending muestra expired.

Ejemplo:

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

Última modificación el 1 de noviembre de 2026