Vai al contenuto principale
POST
curl
Usa questa procedura quando il link precedente non funziona più: la sessione è stata eliminata oppure è scaduta prima che la persona la avviasse. Le sessioni eliminate rientrano in questo caso anche se la persona aveva già avviato o completato la verifica. Le sessioni importate non rientrano per scadenza; devono essere state eliminate. Una sessione non eliminata che la persona aveva già avviato non rientra per scadenza. La nuova sessione è collegata allo stesso soggetto, quindi il suo risultato confluisce nel controllo delle persone chiave come sarebbe confluito il risultato della sessione originale, e il suo link resta valido per la durata di validità della sessione del workflow KYC in cui viene eseguita (da 1 ora a 4 settimane), non per quella della sessione aziendale. Leggi il soggetto e le sue sessioni figlie nella decisione della sessione aziendale. Se la persona non deve essere verificata affatto, ignora il soggetto invece. Vedi Persone chiave per capire come funzionano i soggetti e le loro verifiche.

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 padre di Verifica aziendale (KYB).

Esempio:

"33333333-4444-5555-6666-777777777777"

partyUuid
string<uuid>
obbligatorio

UUID della parte relativa alle persone chiave (key_people_checks[].submitted.parties[].uuid nella decisione della sessione aziendale). Deve appartenere alla sessione a cui fa riferimento sessionId.

Esempio:

"0a3f1e2c-7c2f-4a1b-9d55-2f8d2a5d6b41"

Risposta

Nuova sessione KYC creata. Restituisce il soggetto aggiornato con la sua nuova sessione figlia, che scade dopo il tempo di scadenza della sessione del relativo workflow KYC.

Una parte relativa alle persone chiave di una sessione di Verifica aziendale (KYB), con la relativa verifica figlia. La stessa parte compare in key_people_checks[].submitted.parties[] della decisione sulla sessione aziendale.

uuid
string<uuid>
obbligatorio

Identificativo della parte.

entity_type
enum<string>
obbligatorio

Indica se la parte è una persona fisica o un'azienda.

Opzioni disponibili:
person,
company
source
enum<string>
obbligatorio

REGISTRY: ricavato dal registro delle imprese. USER: inserito nella schermata Persone chiave.

Opzioni disponibili:
REGISTRY,
USER
name
string
obbligatorio

Nome visualizzato della parte.

is_active
boolean
obbligatorio

Indica se la parte è attiva.

is_skipped
boolean
obbligatorio

Indica se la parte è esente dalla verifica. La rigenerazione cancella questa impostazione.

requires_verification
boolean
obbligatorio

Indica se il ruolo e le regole sull'assetto proprietario richiedono una verifica per questa parte.

roles
object[]
obbligatorio

Ruoli ricoperti dalla parte nell'azienda.

kyc_session_deleted
boolean
obbligatorio

La sessione KYC figlia è stata eliminata, pertanto non potrà mai concludersi.

kyb_sub_session_deleted
boolean
obbligatorio

Controparte a livello di azienda di kyc_session_deleted.

first_name
string | null

Nome (persone).

last_name
string | null

Cognome (persone fisiche).

company_name
string | null

Ragione sociale (parti aziendali).

registration_number
string | null

Numero di registrazione dell'azienda (parti aziendali).

email
string<email> | null

Email a cui viene inviato il link di verifica.

nationality
string | null

Nazionalità per le persone fisiche, paese di costituzione per le aziende.

phone_number
string | null

Numero di telefono raccolto per la parte.

date_of_birth
string<date> | null

Data di nascita (persone).

position
string | null

Titolo professionale in formato testo libero (persone).

custom_fields
object

Campi personalizzati definiti dal workflow raccolti per la parte, indicizzati per chiave del campo.

kyc_session_id
string<uuid> | null

Sessione KYC individuale figlia (persone fisiche).

kyc_session_status
enum<string> | null

Stato della sessione KYC figlia. Una sessione eliminata mantiene lo stato che aveva al momento dell'eliminazione.

Opzioni disponibili:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User,
null
kyc_session_url
string<uri> | null

Link ospitato della sessione KYC secondaria. null quando non è presente alcuna sessione o è stata eliminata, e per una chiave API con ambito limitato senza sessions: write.

kyb_sub_session_id
string<uuid> | null

Sessione KYB figlia (parti aziendali).

kyb_sub_session_status
enum<string> | null

Stato della sessione KYB figlia.

Opzioni disponibili:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User,
null
kyb_sub_session_url
string<uri> | null

Link ospitato della sessione KYB secondaria, con le stesse regole per null di kyc_session_url.

verification_workflow_type
enum<string> | null

Tipo di workflow eseguito dalla sessione figlia.

Opzioni disponibili:
kyc,
kyb,
adaptive_age_verification,
biometric_authentication,
address_verification,
questionnaire_verification,
email_verification,
phone_verification,
null
verification_workflow_id
string<uuid> | null

Workflow eseguito dalla sessione figlia.

verification_workflow_label
string | null

Etichetta di quel workflow.

verification_workflow_features
object[] | null

Funzionalità del workflow della sessione figlia con il relativo stato attuale.

didit_internal_id
string<uuid> | null

Identificatore Didit della persona verificata, una volta nota.

Ultima modifica il 7 novembre 2026