Modello dati utente: schema utente del fornitore

Questa pagina documenta ogni campo di un’entità User. I campi si dividono in cinque gruppi: identità, stato, aggregati di sessione, timestamp di attività e metadati.

Campi di identità

Campo	Tipo	Descrizione
`uuid`	UUID	Chiave primaria assegnata da Didit. Stabile e univoca.
`didit_internal_id`	string	Identificatore interno leggibile (visibile nelle risposte API).
`vendor_data`	string	Il tuo identificatore per l’utente. Univoco per applicazione. Scopri di più.
`display_name`	string	Nome alternativo mostrato nella console. Se non impostato, il valore predefinito è `full_name` o `vendor_data`.
`full_name`	string	Nome legale completo, propagato dal documento d’identità della sessione di Verifica degli utenti (KYC) approvata più recente.
`date_of_birth`	date (ISO 8601)	Propagata dalla sessione di Verifica degli utenti (KYC) approvata più recente.
`portrait_image`	URL	URL S3 firmato del selfie tratto dal Rilevamento della vitalità approvato più recente.

full_name, date_of_birth e portrait_image sono di sola lettura quando derivano da una sessione verificata. Puoi sovrascriverli tramite la console o tramite PATCH /v3/users/{vendor_data}/, ma le sovrascritture manuali vengono segnalate nel registro di audit.

Stato

Campo	Tipo	Valori	Descrizione
`status`	enum	`ACTIVE`, `FLAGGED`, `BLOCKED`	Determina le misure applicate alle sessioni e alle transazioni future. Vedi ciclo di vita.

Campi aggregati di sessione

Questi campi sono calcolati da Didit e si aggiornano in tempo reale al completamento delle sessioni.

Campo	Tipo	Descrizione
`session_count`	int	Numero totale di sessioni create per questo utente
`approved_count`	int	Sessioni terminate con `APPROVED`
`declined_count`	int	Sessioni terminate con `DECLINED`
`in_review_count`	int	Sessioni attualmente `IN_REVIEW`
`issuing_states[]`	array di codici paese ISO	Paesi di tutti i documenti d’identità verificati nelle sessioni
`approved_emails[]`	array di stringhe	Email verificate tramite Verifica email
`approved_phones[]`	array di stringhe	Numeri di telefono verificati tramite Verifica telefonica
`features`	object	Stato più recente di ogni funzionalità in tutte le sessioni

La mappa `features`

Ogni sessione esegue una o più funzionalità (verifica dell’identità, vitalità, confronto facciale, AML, prova di residenza, NFC, ecc.). La mappa features contiene lo stato più recente di ogni funzionalità per questo utente:

{
  "id_verification": "APPROVED",
  "liveness": "APPROVED",
  "face_match": "APPROVED",
  "aml": "IN_REVIEW",
  "proof_of_address": "APPROVED",
  "nfc_verification": "NOT_FINISHED"
}

Stati delle funzionalità: NOT_FINISHED, APPROVED, DECLINED, IN_REVIEW, EXPIRED, ABANDONED, RESUB_REQUESTED. Usa la mappa features come percorso rapido per stabilire se un utente è completamente verificato in questo momento, senza scorrere tutte le sessioni.

Timestamp di attività

Campo	Tipo	Aggiornato quando
`first_session_at`	timestamp ISO	È stata creata la prima sessione
`last_session_at`	timestamp ISO	È stata creata o aggiornata la sessione più recente
`last_activity_at`	timestamp ISO	Qualsiasi modifica: sessione, transazione, stato, profilo, note, tag
`created_at`	timestamp ISO	È stata creata la riga dell’entità
`updated_at`	timestamp ISO	La riga dell’entità è stata aggiornata per l’ultima volta

Metadati

Campo	Tipo	Descrizione
`metadata`	object (JSON)	JSON in formato libero sotto il tuo controllo. Usalo per tag interni, livello, fonte di registrazione, ecc.
`tags[]`	array	Tag gestiti da console o API per filtrare e raggruppare

I metadati non hanno uno schema: Didit salva qualsiasi valore tu scriva.

Relazioni (non memorizzate nella riga dell’utente)

Relazione	Come accedervi
Sessioni	`GET /v3/sessions?vendor_data=<value>`
Transazioni (come richiedente)	`GET /v3/transactions/?vendor_data=<value>`
Transazioni (come controparte)	Filtra l’elenco delle transazioni per vendor_data della controparte nella console
Aziende collegate (amministratore / titolare effettivo)	Visibili nella pagina di dettaglio dell’utente nella console
Dati biometrici del volto	Console + Lists API
Voci della blocklist	Lists API: filtra le voci in base agli identificatori dell’utente

Esempio di risposta

{
  "uuid": "9c7d2a30-2f98-4d4f-9d2d-1a7c4b1e5b6a",
  "didit_internal_id": "U-2026-00042",
  "vendor_data": "user-42",
  "display_name": "Jane Doe",
  "full_name": "John Doe",
  "date_of_birth": "1990-01-01",
  "portrait_image": "https://<media-host>/...",
  "status": "ACTIVE",
  "session_count": 3,
  "approved_count": 2,
  "declined_count": 0,
  "in_review_count": 1,
  "issuing_states": ["US", "ES"],
  "approved_emails": ["jane@example.com"],
  "approved_phones": ["+14155550123"],
  "features": {
    "id_verification": "APPROVED",
    "liveness": "APPROVED",
    "face_match": "APPROVED",
    "aml": "IN_REVIEW"
  },
  "first_session_at": "2025-03-01T12:00:00Z",
  "last_session_at": "2026-04-10T09:00:00Z",
  "last_activity_at": "2026-04-16T10:00:00Z",
  "metadata": { "tier": "premium" }
}

Passaggi successivi

Operazioni

Crea, aggiorna, modifica lo stato, elimina.

Storico KYC

Recupera tutte le sessioni associate all’utente.

Riferimento API

Schema di GET /v3/users//.

Panoramica

Prezzi

Workflow e verifica

Revisione e operazioni

Entità (utenti e aziende)

Impostazioni e personalizzazione

Sicurezza e compliance

Didit Academy

Risorse

Modello dati utente: schema utente del fornitore

Campi di identità

Stato

Campi aggregati di sessione

La mappa `features`

Timestamp di attività

Metadati

Relazioni (non memorizzate nella riga dell’utente)

Esempio di risposta

Passaggi successivi

Operazioni

Storico KYC

Riferimento API

​Campi di identità

​Stato

​Campi aggregati di sessione

​La mappa features

​Timestamp di attività

​Metadati

​Relazioni (non memorizzate nella riga dell’utente)

​Esempio di risposta

​Passaggi successivi

Operazioni

Storico KYC

Riferimento API

Campi di identità

Stato

Campi aggregati di sessione

La mappa `features`

Timestamp di attività

Metadati

Relazioni (non memorizzate nella riga dell’utente)

Esempio di risposta

Passaggi successivi