Vai al contenuto principale
POST
curl

Supporto per KYC e KYB

Funziona sia per le sessioni Verifica degli utenti (KYC) sia per le sessioni Verifica aziendale (KYB). Didit cerca il session_id in entrambi i tipi di sessione e genera un token di condivisione JWT che include:
Quando il partner destinatario importa il token, Didit clona il tipo di sessione corrispondente (KYC o KYB) con le relative relazioni.

Requisiti

  • La sessione deve trovarsi in uno stato concluso (APPROVED, DECLINED, IN_REVIEW).
  • Devi disporre del privilegio write:sessions.
  • Il for_application_id deve essere un’applicazione Didit valida (di solito l’applicazione di un partner).

Esempi

Risposta:

Limiti del TTL

Contenuti correlati

Autorizzazioni

x-api-key
string
header
obbligatorio

La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys.

Parametri del percorso

sessionId
string<uuid>
obbligatorio

UUID della sessione di verifica di origine per cui generare un token.

Esempio:

"11111111-2222-3333-4444-555555555555"

Corpo

application/json
for_application_id
string<uuid>
obbligatorio

UUID dell'applicazione Didit che riscatterà il token. Deve esistere, non deve essere eliminata e deve essere diversa dall'applicazione chiamante. Puoi trovarlo nella Business Console sotto Settings → Application.

Esempio:

"a5f3bca2-46e2-411e-90ef-a580900a57ee"

ttl_in_seconds
integer
predefinito:3600

Durata del token, in secondi. Minimo 60, massimo 86400 (24 ore). Il valore predefinito è 3600 (1 ora).

Intervallo richiesto: 60 <= x <= 86400
Esempio:

3600

Risposta

Token di condivisione generato.

share_token
string

JWT firmato con HS256. Passalo così com'è come share_token a POST /v3/session/import-shared/ sull'applicazione di destinazione.

Esempio:

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

for_application_id
string<uuid>

Restituisce l'UUID dell'applicazione di destinazione a cui è associato il token.

Esempio:

"a5f3bca2-46e2-411e-90ef-a580900a57ee"

session_kind
enum<string>

Indica se la sessione di origine è una sessione di Verifica degli utenti (KYC) o di Verifica aziendale (KYB).

Opzioni disponibili:
user,
business
Ultima modifica il 7 novembre 2026