Trust Center
Verifichi i Suoi utenti: documenti d'identità, confronto del volto e controlli societari.
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.
Invia il link
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.
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.
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.