Storico KYC utente: sessioni e nuova verifica

Ogni sessione di Verifica degli utenti (KYC) eseguita da un utente rimane collegata in modo permanente alla sua entità User. Puoi recuperare la cronologia completa, ispezionare i risultati delle singole sessioni, avviare una nuova verifica ed esportare report di conformità.

Elencare tutte le sessioni di un utente

Filtra l’elenco delle sessioni per vendor_data:

curl -G https://verification.didit.me/v3/sessions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "vendor_data=user-42" \
  --data-urlencode "page_size=50"

La risposta include tutte le sessioni, indipendentemente dallo stato: approvate, rifiutate, in revisione, abbandonate o scadute.

Comprendere gli aggregati delle funzionalità

La mappa features dell’entità User riflette lo stato più recente di ciascuna funzionalità in tutte le sessioni:

"features": {
  "id_verification": "APPROVED",
  "liveness": "APPROVED",
  "face_match": "APPROVED",
  "aml": "IN_REVIEW"
}

Usala come percorso rapido per sapere se l’utente è verificato in questo momento. Per la cronologia completa, cioè tutte le sessioni, tutte le funzionalità e tutti i risultati, elenca le sessioni e ispeziona ciascuna decisione.

Ispezionare una singola sessione

curl https://verification.didit.me/v3/session/{session_id}/decision/ \
  -H "x-api-key: YOUR_API_KEY"

La decisione include:

Risultati per funzionalità (ID, Rilevamento della vitalità, confronto facciale, AML, prova di residenza, NFC e altri)
Dati estratti dal documento e immagini (URL firmati)
Riscontri AML con punteggi di corrispondenza e di rischio
Analisi dispositivo e IP e contesto del dispositivo
Note del revisore e azioni manuali

Consulta recupera sessione per lo schema completo.

Avviare una nuova verifica

Quando devi chiedere a un utente di verificarsi di nuovo (ad esempio per un KYC annuale, per la scadenza di un documento o per un controllo attivato da un trigger):

curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "wf_reverification",
    "vendor_data": "user-42"
  }'

La nuova sessione viene collegata alla stessa entità User. Al completamento, la mappa features dell’entità si aggiorna con i nuovi risultati.

Reinvio o nuova sessione

Scenario	Utilizzo
La sessione dell’utente è stata rifiutata per un problema risolvibile (documento sfocato, illuminazione scarsa)	Invia di nuovo la stessa sessione con un nuovo caricamento
Nuova verifica completa o KYC periodico	Crea una nuova sessione
Rimedio attivato da una regola sulle transazioni	La transazione crea automaticamente una sessione di rimedio (stato `AWAITING_USER`)

Esportare un report di conformità

Per audit, segnalazioni di operazioni sospette (SAR) o richieste delle autorità di vigilanza, genera un PDF per qualsiasi sessione:

curl https://verification.didit.me/v3/session/{session_id}/generate-pdf/ \
  -H "x-api-key: YOUR_API_KEY" \
  -o session-report.pdf

Per raccogliere l’intera cronologia di un utente in un unico file, scarica il PDF della cronologia utente: una pagina di copertina (riepilogo del profilo, stato delle funzionalità, indice delle sessioni) seguita dal report completo di ogni sessione segnalabile, dalla più vecchia alla più recente, limitato alle 20 più recenti.

curl --fail https://verification.didit.me/v3/users/user-42/generate-pdf/ \
  -H "x-api-key: YOUR_API_KEY" \
  -o user-history.pdf

È lo stesso documento prodotto dalla console con Users → [user] → Actions → Download PDF. Per esportazioni CSV in blocco di molti utenti, usa l’esportazione a livello di applicazione in Review & Operations → Export PDF/CSV.

Condividere una sessione con una terza parte

Quando devi condividere la verifica di un utente con un’app partner (ad esempio in uno scenario di KYC riutilizzabile), usa:

POST /v3/session/{session_id}/share/: genera un token condivisibile.
POST /v3/session/import-shared/: importa una sessione condivisa dal lato ricevente.

Consulta KYC riutilizzabile per il modello completo.

Flussi di lavoro basati sulla cronologia

Usa la cronologia delle sessioni per prendere decisioni di conformità più efficaci:

Salta i passaggi se l’utente ha già un rilevamento della vitalità approvato da meno di N giorni.
Richiedi controlli aggiuntivi se l’ultima sessione dell’utente è stata rifiutata.
Segnala quando il numero di sessioni di un utente aumenta in modo inatteso.
Monitora le riscansioni AML continue tramite la funzionalità di monitoraggio continuo.

Passaggi successivi

Modello dati

Come vengono calcolati la mappa delle funzionalità e i contatori.

Recupera sessione

Schema completo della decisione della sessione.

KYC riutilizzabile

Riutilizza i dati verificati tra più applicazioni.

Panoramica

Prezzi

Workflow e verifica

Revisione e operazioni

Entità (utenti e aziende)

Impostazioni e personalizzazione

Sicurezza e compliance

Didit Academy

Risorse

Storico KYC utente: sessioni e nuova verifica

Elencare tutte le sessioni di un utente

Comprendere gli aggregati delle funzionalità

Ispezionare una singola sessione

Avviare una nuova verifica

Reinvio o nuova sessione

Esportare un report di conformità

Condividere una sessione con una terza parte

Flussi di lavoro basati sulla cronologia

Passaggi successivi

Modello dati

Recupera sessione

KYC riutilizzabile

​Elencare tutte le sessioni di un utente

​Comprendere gli aggregati delle funzionalità

​Ispezionare una singola sessione

​Avviare una nuova verifica

​Reinvio o nuova sessione

​Esportare un report di conformità

​Condividere una sessione con una terza parte

​Flussi di lavoro basati sulla cronologia

​Passaggi successivi

Modello dati

Recupera sessione

KYC riutilizzabile

Elencare tutte le sessioni di un utente

Comprendere gli aggregati delle funzionalità

Ispezionare una singola sessione

Avviare una nuova verifica

Reinvio o nuova sessione

Esportare un report di conformità

Condividere una sessione con una terza parte

Flussi di lavoro basati sulla cronologia

Passaggi successivi