אימות זהות מתארח, כשההחלטה נשארת בידיכם

בדיקות ואותות

התהליך המתארח מפיק תוצאות בדיקה לעיון של בודק. אלה אותות שמסייעים בבדיקה. הם אינם קובעים תוצאה ואינם מבטיחים חסימת הונאה.

למפתחים

כל מה שמופיע למטה הוא HTTPS פשוט מהשרת שלך. המפרט המלא נמצא בתיעוד.

שלוש דרכים להתחיל אימות

• הפעלה מתארחת מהשרת שלך. השרת שלך יוצר את הקישור באמצעות API, ו-Noxtica מארחת את הדף.
• הזמנה מ-Backoffice. אדם בארגון שלך יוצר את הקישור ב-Backoffice, ללא קוד.
• API ישיר מהשרת שלך. מסלולים בין שרתים ללא קישור מתארח. כיום הם אינם מאפשרים למסכים שלך לצלם מסמך לבדיקה, לכן יש להשתמש בהפעלה מתארחת כשהלקוח צריך לצלם מסמך.

יצירת הפעלה

יש לבצע אימות באמצעות מפתח שרת בעל הרשאת זהות. יש לשמור את המפתח בשרת שלך. יש לשלוח Idempotency-Key כדי שניסיון חוזר לא ייצור הפעלה נוספת.

curl -sS https://collect.noxtica.com/v1/kyc/sessions \
  -H "Authorization: Bearer $NOXTICA_SERVER_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"subjectRef":"cust_example","returnUrl":"https://merchant.example.com/verification/return"}'

התגובה

הקישור מוחזר פעם אחת בלבד, בתגובה הזו. יש להתייחס אליו כאל סוד ולא לרשום אותו ביומן. מועד התפוגה מצוין באלפיות שנייה של epoch.

{
  "ok": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "url": "https://verify.noxtica.com/s/EXAMPLE_TOKEN",
  "expiresAt": 1790848845000,
  "domainId": null,
  "requestId": "req_example"
}

קריאת הסטטוס

הפעלה שיצרת תמיד מחזירה 200, גם אם פג תוקפה. יש לבדוק שוב בהשהיה שהולכת וגדלה ולהפסיק כשהסטטוס סופי.

GET https://collect.noxtica.com/v1/kyc/sessions/00000000-0000-4000-8000-000000000001
Authorization: Bearer $NOXTICA_SERVER_KEY

אירועי Webhook

אירועים נשלחים במסירות HTTPS חתומות לנקודת קצה שרשמת ב-Backoffice. אירוע הוא התראה, לא החלטה.

אירוע לדוגמה

ערכים סינתטיים בלבד. האירועים לעולם אינם כוללים את מזהה הלקוח שלך: יש להתאים אירוע ללקוח שלך לפי מזהה ההפעלה.

{
  "id": "00000000-0000-4000-8000-000000000001:endpoint_example",
  "type": "kyc.session.completed",
  "created_at": 1790762445000,
  "tenant_id": "tenant_example",
  "data": {
    "schemaVersion": "1",
    "sessionId": "00000000-0000-4000-8000-000000000001",
    "status": "completed",
    "verificationId": "verification_example",
    "reasonCodes": ["provider_manual_review"],
    "occurredAt": 1790762445000,
    "deliveryId": "00000000-0000-4000-8000-000000000001:endpoint_example"
  }
}

יש לאמת כל מסירה

• כל מסירה כוללת את הכותרות X-Noxtica-Signature, X-Noxtica-Timestamp, X-Noxtica-Event ו-X-Noxtica-Delivery.
• החתימה היא HMAC-SHA256 על חותמת הזמן, נקודה וגוף הבקשה הגולמי. יש לאמת אותה לפני ניתוח גוף הבקשה, ולאכוף סבילות לחותמת זמן לפי המדיניות שלך.
• המסירה מתבצעת לפחות פעם אחת, וסדר המסירה אינו קבוע. יש למנוע כפילויות לפי X-Noxtica-Delivery, ואז לקרוא את סטטוס ההפעלה לפני פעולה.

אין צורך ב-SDK. בתיעוד מופיעות דוגמאות ב-curl, Node.js וב-Python.

מידע נוסף בתיעוד

• שילוב אימות זהות
• אירועים ו-webhooks
• מפרט API לשרת: KYC
• הזמנות והגדרות הדף המתארח
• API ישיר
• מדיניות חיות ו-PAD
• שאלות נפוצות ופתרון בעיות
• תפעול ב-Backoffice

שאלות נפוצות

עמודים קשורים

• צפו בחוויית האימות המתארחת
• תמחור
• אימות עסקים ובתי עסק (KYB ו-KYM)
• נתוני אימות: אחסון, גישה ומחיקה
• מדיניות הפרטיות
• אבטחה