Vai al contenuto principale
La Business Console consente al tuo team di gestire in blocco le entità User senza scrivere codice. Sono supportati due flussi: importazione CSV (creare o aggiornare utenti su larga scala) ed esportazione CSV (estrarre la tabella degli utenti per strumenti esterni).
L’importazione e l’esportazione in blocco creano o aggiornano solo i profili User. Non ricreano le sessioni KYC storiche, gli avvisi sui documenti, le prove di vitalità né le decisioni dei provider. Per una migrazione completa da Sumsub, MetaMap, Veriff, Onfido, Persona o da un altro provider, consulta Importare dati da un altro provider.

​
Importare utenti da CSV

​
Quando usarlo

  • Migrazione iniziale da un altro fornitore KYC: porta con te l’elenco degli utenti esistenti.
  • Migrazione dei volti dal provider: allega le immagini dei volti attendibili ai profili User importati dopo la creazione delle righe.
  • Onboarding in blocco della lista clienti di un partner.
  • Aggiornamento retroattivo dei metadati: aggiorna tag, livello o identificativi interni di molti utenti contemporaneamente.

​
Colonne del modello

Scarica il modello da Users → Import → Download template. Colonne:

​
Esecuzione dell’importazione

1

Carica il CSV

Vai a Users → Import → Upload CSV e seleziona il file.
2

Controlla l'anteprima

La console convalida ogni riga. Le righe non valide sono evidenziate con il motivo dell’errore (ad esempio vendor_data duplicato o codice paese non valido).
3

Avvia l'importazione

Didit elabora le righe in modo asincrono. Puoi chiudere la scheda: l’avanzamento è visibile in Users → Import history.
4

Controlla i risultati

Al termine dell’importazione, la cronologia mostra il numero di righe create, aggiornate e saltate, insieme a un report degli errori scaricabile.

​
Aggiornamento o creazione

  • Se un vendor_data non esiste, viene creato un nuovo User.
  • Se un vendor_data esiste già, la riga aggiorna lo User esistente (campi del profilo e metadati).
  • I contatori aggregati e i campi verificati (full_name, date_of_birth dalle sessioni approvate) non vengono mai sovrascritti dalle importazioni.

​
Importare i volti dopo la creazione dell’utente

L’importazione CSV crea o aggiorna la riga User, ma non include immagini dei volti nel CSV. Per trasferire i dati biometrici dei volti da un altro provider, carica ogni volto dopo che lo User di destinazione esiste:
1

Crea o importa lo User

Usa l’importazione CSV nella console oppure chiama POST /v3/users/create/ in un ciclo.
2

Leggi didit_internal_id

Recupera l’User con GET /v3/users/{vendor_data}/. La risposta include didit_internal_id.
3

Carica il volto

Chiama POST /v3/organization/{organization_id}/application/{application_id}/vendor-users/by-id/{didit_internal_id}/faces/upload/ con un’immagine del volto in base64 non elaborata.
Il volto deve essere un’immagine valida, di massimo 2 MB una volta decodificata, e deve contenere un volto rilevabile. Didit lo salva nel profilo e lo indicizza per il rilevamento dei duplicati e per la ricerca facciale. Non viene aggiunto a una blocklist di volti, a meno che tu non utilizzi separatamente l’endpoint Upload face to list.

​
Esportare utenti in CSV

​
Quando usarlo

  • Audit di conformità: consegna la tabella completa degli utenti ai revisori.
  • Sincronizzazione con il data warehouse: esportazione periodica verso i tuoi strumenti di business intelligence.
  • Richieste SAR o delle autorità di vigilanza: estrai sottoinsiemi filtrati di utenti.

​
Esecuzione di un’esportazione

  1. Vai a Users → Export.
  2. Applica i filtri (stato, paese, intervallo di date, ricerca).
  3. Scegli le colonne (per impostazione predefinita sono tutti i campi; puoi eliminare le colonne che non ti servono).
  4. Invia. Didit genera l’esportazione in modo asincrono e invia via email un link di download firmato all’operatore che l’ha richiesta.
Le esportazioni includono solo i dati che il tuo ruolo è autorizzato a leggere. COMPLIANCE_OFFICER e i ruoli superiori possono esportare l’intera tabella; i ruoli DEVELOPER e READER hanno esportazioni limitate.

​
Caratteristiche di prestazione

​
Traccia di audit

Ogni importazione ed esportazione viene registrata nel registro di audit:
  • L’operatore che l’ha avviata.
  • Numero di righe (importazioni) / istantanea dei filtri (esportazioni).
  • Marcature temporali e stato di riuscita o di errore.

​
Passi successivi

API per creare utenti

Creazione programmatica per importazioni automatizzate.

Caricare il volto dell'utente

Allega le immagini dei volti importate ai profili User.

Conservazione dei dati

Per quanto tempo persistono i dati importati.

Registri di audit

Consulta la cronologia di importazioni ed esportazioni.
Ultima modifica il 7 novembre 2026