تأیید هویت میزبانی‌شده؛ تصمیم با شماست

بررسی‌ها و نشانه‌ها

فرایند میزبانی‌شده نتایج بررسی را برای بازبین ارائه می‌کند. این نتایج نشانه‌هایی برای بررسی هستند؛ نه تصمیم‌گیرنده درباره نتیجه‌اند و نه تضمینی برای مسدودسازی تقلب.

برای توسعه‌دهندگان

همه موارد زیر از سرور شما و از طریق HTTPS ساده انجام می‌شوند. مرجع کامل در مستندات آمده است.

سه راه برای شروع احراز هویت

• جلسه میزبانی‌شده از سرور شما. سرور شما پیوند را از طریق API ایجاد می‌کند و میزبانی صفحه بر عهده Noxtica است.
• دعوت از Backoffice. فردی در سازمان شما بدون کدنویسی، پیوند را در Backoffice ایجاد می‌کند.
• Direct 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 دارد.

اطلاعات بیشتر در مستندات

• یکپارچه‌سازی احراز هویت
• رویدادها و Webhookها
• مرجع Server API: KYC
• دعوت‌نامه‌ها و تنظیمات صفحه میزبانی‌شده
• Direct API
• سیاست زنده‌بودن و PAD
• سؤالات متداول و عیب‌یابی
• عملیات در Backoffice

پرسش‌های رایج

صفحه‌های مرتبط

• تجربه احراز هویت میزبانی‌شده را ببینید
• قیمت‌گذاری
• احراز هویت کسب‌وکارها و پذیرندگان (KYB و KYM)
• داده‌های احراز هویت: ذخیره‌سازی، دسترسی و حذف
• سیاست حفظ حریم خصوصی
• امنیت