التحقق من الهوية عبر تدفق مستضاف، مع ترك القرار لكم

الفحوصات والمؤشرات

ينتج التدفق المستضاف نتائج الفحوصات ليطّلع عليها المراجع. وهي مؤشرات تساعد في المراجعة، ولا تحسم النتيجة ولا تضمن حظر الاحتيال.

للمطورين

كل ما يلي اتصالات HTTPS عادية من خادمك. تجد المرجع الكامل في الوثائق.

ثلاث طرق لبدء التحقق

• جلسة مستضافة من خادمك. ينشئ خادمك الرابط عبر API، وتستضيف Noxtica الصفحة.
• دعوة من باك أوفيس. ينشئ شخص في مؤسستك الرابط في باك أوفيس، من دون كتابة أي تعليمات برمجية.
• 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"}'

الاستجابة

يُعاد الرابط مرة واحدة في هذه الاستجابة. تعامل معه كسر ولا تسجله. وقت انتهاء الصلاحية بوحدة المللي ثانية منذ الحقبة.

{
  "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 موقعة إلى نقطة نهاية تسجلها في باك أوفيس. الحدث إشعار وليس قرارًا.

حدث نموذجي

قيم اصطناعية فقط. لا تتضمن الأحداث مرجع العميل الخاص بك مطلقًا؛ طابق الحدث مع عميلك باستخدام معرّف الجلسة.

{
  "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
• مرجع Server API: KYC
• الدعوات وإعدادات الصفحة المستضافة
• API مباشر
• سياسة الحيوية وPAD
• الأسئلة الشائعة واستكشاف الأخطاء وإصلاحها
• العمليات في باك أوفيس

أسئلة شائعة

صفحات ذات صلة

• اطّلع على تجربة التحقق المستضافة
• التسعير
• التحقق من الشركات والتجار (KYB وKYM)
• بيانات التحقق: التخزين والوصول والحذف
• سياسة الخصوصية
• الأمان