Trust Center
אימות המשתמשים שלכם: מסמכי זהות, השוואת פנים ובדיקות חברה.
שלוש שיטות עושות מהקוד את מה שהחלון אימות אדם עושה: פותחות סשן, קוראות סשן ומפרטות סשנים. כל אחת פועלת על ה-Trust Center של החשבון שמפתח ה-API שלכם שייך לו.
פותחים סשן
קוראים ל-verify_session_create. שולחים level (1 עד 4, ברירת מחדל 2) ואם רוצים, external_ref משלכם (עד 200 תווים). התשובה נושאת session_id, hosted_url לשלוח לאדם, ו-expires_at, שהוא 24 שעות קדימה.
שולחים את הקישור
מפנים את המשתמש שלכם אל hosted_url, או שולחים לו אותו.
קוראים את התוצאה
קוראים ל-verify_session_result עם ה-session_id. היא מחזירה את ה-status, את ה-external_ref שלכם, את הזמנים ואת ה-result ברגע שהסשן הושלם.
מה קובע את הסשן
- המצב. סשן הוא בדיקה כשהשירות פועל במצב בדיקה, ולייב כשהוא פועל בלייב. סשנים של בדיקה הם חינם ואף פעם לא נספרים, ואפשר לסיים אותם מהדשבורד. עדיין אי אפשר להשלים קישורי לייב.
- הרמה. רמה מעל מה שהתוכנית שלכם מאפשרת נדחית, עם ציון איזו תוכנית נושאת אותה. הבקשה אף פעם לא מורדת בשקט.
- מעבר למכסה. סשן לייב מעבר למכסה החודשית של התוכנית נדחה ב-Free, ובתוכנית בתשלום הוא נוצר ומסומן כחריגה.
מפתחות נוצרים ב-Developers, ויצירת מפתח דורשת רמה 2 משלכם.
Webhooks
מ-Starter ומעלה, קובעים כתובת בהגדרות Trust Center ובקשה חתומה נשלחת כשאימות מוכרע, כך שאין צורך לבצע polling. כל אחת נושאת כותרת Xuda-Event וכותרת Xuda-Signature שמורכבת מחותמת זמן ומ-HMAC של חותמת הזמן והגוף, חתום בסוד שמוצג פעם אחת בהגדרות. משלוח שנכשל מנוסה שוב, עד חמישה ניסיונות.