Vai al contenuto principale
GET
Recupera uno step-up
L’autenticazione è una novità. Questi endpoint sono erogati dall’emittente della tua applicazione, ad esempio https://<name>.auth.didit.me, e non accettano mai la tua chiave API Didit.
Uno step-up appartiene alla sessione che lo ha creato: il token di accesso di un’altra sessione restituisce 404. Uno step-up in stato pending risulta expired una volta trascorsi 30 minuti.

Autorizzazioni

Authorization
string
header
obbligatorio

Il token di accesso della persona restituito da POST /token/: un JWT ES256 con intestazione typ: at+jwt, valido per un massimo di 5 minuti. Non la tua chiave API di Didit.

Parametri del percorso

step_up_id
string<uuid>
obbligatorio

L'id proveniente da POST /step-up/, coincidente anche con il parametro di query step_up sul tuo return_to. Un valore che non è un UUID genera una pagina 404, non JSON.

Risposta

Lo step-up.

Una verifica che la persona deve superare prima dell'azione.

id
string<uuid>
obbligatorio
Esempio:

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

rule
enum<string>
obbligatorio

La regola che lo ha richiesto. Quando se ne applicano diverse, quella con il metodo più rigoroso.

Opzioni disponibili:
payout,
device,
bank,
contact
Esempio:

"payout"

method
enum<string>
obbligatorio

Cosa fa la persona: liveness, selfie (rilevamento della vitalità confrontato con il volto già in possesso di Didit) o full_id (documento e selfie). Quando Didit non possiede ancora alcun volto per la persona, selfie diventa full_id non appena apre verification_url.

Opzioni disponibili:
liveness,
selfie,
full_id
Esempio:

"selfie"

status
enum<string>
obbligatorio

Intervieni solo su approved. review è in attesa della revisione da parte del tuo team. declined non è definitivo finché verification_url è attivo: la persona può riprovare e la verifica step-up torna a pending. superseded significa che un altro controllo ha preso in carico la relativa verifica, oppure che il risultato non era destinato a questa verifica step-up: creane una nuova.

Opzioni disponibili:
pending,
review,
approved,
declined,
expired,
superseded
Esempio:

"pending"

level
enum<string> | null
obbligatorio

Il livello raggiunto dalla verifica, una volta approvata.

Opzioni disponibili:
liveness,
liveness_face_match,
full_id,
null
Esempio:

null

amount
string | null
obbligatorio

L'importo del payout, due decimali.

Esempio:

"900.00"

currency
string | null
obbligatorio
Esempio:

"USD"

created_at
string<date-time>
obbligatorio
Esempio:

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

completed_at
string<date-time> | null
obbligatorio
Esempio:

null

expires_at
string<date-time>
obbligatorio

30 minuti dopo la creazione. La lettura di uno step-up raccoglie prima qualsiasi risultato raggiunto dalla relativa verifica, quindi può ancora riportare approved, review o declined dopo questo intervallo; uno ancora pending riporta expired.

Esempio:

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

Ultima modifica il 7 novembre 2026