Trust Center
Verifiera dina egna användare: id-handlingar, ansiktsmatchning och företagskontroller.
Tre metoder gör från kod det som fönstret Verifiera någon gör: öppna en session, läsa en session och lista sessioner. Varje metod verkar på Trust Center för kontot vars API-nyckel du använder.
Öppna en session
Anropa verify_session_create. Skicka level (1 till 4, standard 2) och, om du vill, din egen external_ref (högst 200 tecken). Svaret innehåller ett session_id, en hosted_url att skicka till personen och expires_at, som är 24 timmar framåt.
Skicka länken
Omdirigera din användare till hosted_url, eller skicka den till dem.
Läs resultatet
Anropa verify_session_result med session_id. Den returnerar status, din external_ref, tiderna och result när sessionen är klar.
Vad som avgör sessionen
- Läget. En session är ett test när tjänsten körs i Testläge och live när den körs i Live. Testsessioner är gratis, räknas aldrig och kan avslutas från dashboarden. Livelänkar kan inte slutföras än.
- Nivån. En nivå över vad din plan tillåter nekas, med besked om vilken plan som har den. Förfrågan sänks aldrig i tysthet.
- Över kvoten. En livesession över din plans månadskvot nekas på Gratis, och på en betald plan skapas den och markeras som överskjutande.
Nycklar skapas i Developers, och för att skapa en krävs din egen nivå 2.
Webhooks
På Starter och uppåt anger du en adress i Trust Center-inställningarna, och en signerad förfrågan skickas när en verifiering avgjorts, så att du slipper polla. Varje förfrågan har en Xuda-Event-header och en Xuda-Signature-header som består av en tidsstämpel och en HMAC av tidsstämpeln och innehållet, signerad med hemligheten som visas en gång i inställningarna. En leverans som misslyckas görs om, upp till fem försök.