Inizia
Integrazione / SDK
Verifica degli utenti
Verifica aziendale
Monitoraggio delle transazioni
ChangelogSessioni ospitate (consigliate per i flussi rivolti agli utenti)
Le sessioni ospitate sono l’approccio consigliato per la maggior parte delle integrazioni. Quando crei una sessione, Didit genera unverification_url che presenti al tuo utente. L’utente completa l’intero flusso di verifica nell’interfaccia ottimizzata di Didit, e tu ricevi i risultati tramite webhook o API.
Come funziona
1
Crea sessione
Il tuo server chiama
POST /v3/session/ con un ID del workflow. Didit restituisce un verification_url e un session_token.2
Presenta all'utente
Reindirizza l’utente, integra la sessione tramite iframe o inizializza un SDK nativo usando il token di sessione.
3
L'utente completa la verifica
L’utente segue il flusso guidato nell’interfaccia ottimizzata di Didit: acquisizione del documento, rilevamento della vitalità e gli eventuali passaggi aggiuntivi.
4
Ricevi i risultati
Didit invia un webhook al tuo server con la decisione di verifica, oppure puoi interrogare il servizio tramite l’API di recupero.
Perché le sessioni sono consigliate
Quando usare le sessioni
- Onboarding utenti / KYC: i nuovi utenti si registrano e devono verificare la propria identità
- Verifica dell’età: confermi che gli utenti rispettino i requisiti minimi di età
- Nuova verifica: verifichi periodicamente gli utenti esistenti
- Autenticazione biometrica: gli utenti si autenticano con il volto per le azioni sensibili
- Conformità a più passaggi: flussi che richiedono ID, rilevamento della vitalità, AML e telefono in un’unica volta
- Qualsiasi scenario in cui l’utente finale è presente e interagisce direttamente
Endpoint delle sessioni
API standalone (per l’elaborazione server-to-server)
Le API standalone ti permettono di chiamare le singole funzionalità di verifica direttamente dal tuo server, senza alcuna interfaccia utente. Invii i dati (immagini, documenti, nomi) e ricevi risultati strutturati.Come funziona
1
Invia i dati
Il tuo server chiama un endpoint standalone (ad esempio
POST /v3/id-verification/) con i dati richiesti: immagini, documenti o campi JSON.2
Ricevi i risultati
Didit elabora la richiesta in modo sincrono e restituisce nella risposta i risultati di verifica strutturati.
Quando usare le API standalone
API standalone disponibili
Identità e documenti
Document AI
Biometria e volto
Compliance e rischio
Verifica bancaria
Verifica aziendale (KYB)
Confronto affiancato
Posso usarle entrambe?
Sì. Molti team combinano i due approcci:- Sessioni per l’onboarding: i nuovi utenti completano il flusso di verifica ospitato durante la registrazione
- AML standalone per il monitoraggio continuo: un cron job ricontrolla ogni notte tutti gli utenti approvati rispetto alle watchlist aggiornate
- Ricerca facciale standalone per il rilevamento dei duplicati: quando una nuova sessione viene approvata, il tuo server chiama la Ricerca facciale per verificare la presenza di duplicati
- Verifica dell’identità standalone per le operazioni: il tuo team di compliance carica manualmente i documenti per le revisioni dei casi limite