Vai al contenuto

Trust Center

Verifichi i Suoi utenti: documenti d'identità, confronto del volto e controlli societari.

Apri Trust Center
Verificato rispetto alla dashboard il 18 novembre 2026

Tre metodi fanno da codice ciò che fa la finestra Verifica qualcuno: aprire una sessione, leggere una sessione ed elencare le sessioni. Ognuno agisce sul Trust Center dell'account di cui usi la chiave API.

Apri una sessione

Chiama verify_session_create. Invia level (da 1 a 4, predefinito 2) e, se vuoi, un tuo external_ref (al massimo 200 caratteri). La risposta contiene un session_id, un hosted_url da inviare alla persona e expires_at, che è 24 ore dopo.

Reindirizza il tuo utente a hosted_url, oppure invialo a lui.

Leggi il risultato

Chiama verify_session_result con il session_id. Restituisce lo status, il tuo external_ref, gli orari e il result una volta completata la sessione.

curl -s https://xuda.ai/cpi/verify_session_create \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","level":2,"external_ref":"user_482"}'
const res = await fetch('https://xuda.ai/cpi/verify_session_create', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ api_key: 'YOUR_API_KEY', level: 2, external_ref: 'user_482' }),
});
const { code, data } = await res.json();
// data.hosted_url is where you send this user next.
import requests

res = requests.post(
    'https://xuda.ai/cpi/verify_session_create',
    json={'api_key': 'YOUR_API_KEY', 'level': 2, 'external_ref': 'user_482'},
)

Che cosa decide la sessione

  • La modalità. Una sessione è di test quando il servizio gira in modalità di test, e live quando gira in Live. Le sessioni di test sono gratuite, non vengono mai contate e si possono terminare dalla dashboard. I link live non si possono ancora completare.
  • Il livello. Un livello superiore a quello che il tuo piano consente viene rifiutato, indicando quale piano lo include. La richiesta non viene mai abbassata in silenzio.
  • Oltre la quota. Una sessione live oltre la quota mensile del tuo piano viene rifiutata su Free, e su un piano a pagamento viene creata e segnata come eccedenza.

Le chiavi si creano in Sviluppatori, e crearne una richiede il tuo Livello 2.

Rifiuti

Webhook

Da Starter in su, imposta un indirizzo nelle impostazioni di Trust Center e viene inviata una richiesta firmata quando una verifica viene decisa, così non devi fare polling. Ognuna porta un'intestazione Xuda-Event e un'intestazione Xuda-Signature composta da un timestamp e da un HMAC del timestamp e del corpo, firmato con il segreto mostrato una sola volta nelle impostazioni. Una consegna che fallisce viene ritentata, fino a cinque tentativi.

Come ti sembra questa guida?

Ultimo aggiornamento il 16 novembre 2026