دریافت تصویر کارت ملی

کاربرد کسب‌وکاری (نسخه Client Credential بدون رضایت پیامکی): با کد ملی، سریال کارت ملی و تاریخ تولد، عکس کارت ملی مشتری بازگردانده می‌شود.

مستندات فنی

سرویس «دریافت تصویر کارت ملی» در دسته احراز هویت و شناخت مشتری فینوتک با گرفتن کد ملی، سریال کارت ملی و تاریخ تولد، تصویر کارت ملی همان شخص را همراه کد پیگیری ثبت احوال برمی‌گرداند. با این سرویس می‌توانید تصویر مدرک هویتی مشتری را بدون درخواست آپلود عکس از او در پرونده احراز هویت ثبت کنید.

دریافت تصویر کارت ملی چه مشکلی را حل می‌کند؟

در بیشتر فرآیندهای ثبت‌نام غیرحضوری، کاربر باید با موبایل از کارت ملی خود عکس بگیرد و آن را بارگذاری کند. نتیجه معمولاً تصویری است تار، کج، با انعکاس نور یا بریده‌شده که کارشناس باید دستی بازبینی کند و بارها از کاربر عکس تازه بخواهد؛ همین رفت‌وبرگشت بخشی از متقاضیان را در میانه فرم رها می‌کند. در حالت‌های پرریسک‌تر، تصویر بارگذاری‌شده به شخص دیگری تعلق دارد یا در نرم‌افزار ویرایش شده است و تشخیص آن به چشم و حوصله کارشناس واگذار می‌شود.

این سرویس جهت جریان را عوض می‌کند: به‌جای اینکه تصویر را از کاربر بگیرید و بعد درستی آن را بسنجید، با کد ملی، سریال کارت ملی و تاریخ تولد تصویر کارت ملی را از طریق API دریافت می‌کنید و کد پیگیری ثبت احوال را هم در پرونده ذخیره می‌کنید. خروجی، مبنای دو تصمیم است: اینکه پرونده هویتی مشتری کامل و قابل ممیزی باشد، و اینکه تصویر رسمی به‌عنوان مرجع مقایسه در مراحل بعدی احراز هویت — مثل تطبیق چهره — در دست شما باشد.

کاربردهای دریافت تصویر کارت ملی

  • افتتاح حساب و پذیرش غیرحضوری در خدمات مالی — پرونده هویتی متقاضی با تصویر کارت ملی تکمیل می‌شود، بدون آنکه فرم ثبت‌نام به مرحله بارگذاری فایل گره بخورد.
  • آماده‌سازی مرجع مقایسه برای تطبیق چهره — تصویر دریافتی به‌عنوان تصویر مرجع در جریان‌های انطباق ویدئو با عکس کارت ملی به کار می‌رود.
  • پرونده‌سازی در تسهیلات، لیزینگ و خرید اعتباری — همراه استعلام‌های هویتی، تصویر مدرک شناسایی متقاضی برای بایگانی قرارداد ثبت می‌شود.
  • صدور بیمه‌نامه و ثبت خسارت — هنگام ثبت بیمه‌گزار یا ذی‌نفع، تصویر مدرک شناسایی بدون مراجعه به نمایندگی به پرونده اضافه می‌شود.
  • تکمیل پرونده‌های ناقص و قدیمی — پرونده‌هایی که تصویر مدرک هویتی ندارند یا تصویر آن‌ها ناخوانا است، در بازبینی دوره‌ای اصلاح می‌شود.
  • کاهش بار بازبینی دستی در تیم پشتیبانی — تصویر بارگذاری‌شده توسط کاربر دیگر تنها منبع پرونده نیست و صف بررسی عکس‌های ناخوانا کوتاه می‌شود.

مزایای دریافت تصویر کارت ملی

  • حذف مرحله آپلود از تجربه کاربر — کاربر فقط اطلاعات هویتی را وارد می‌کند و لازم نیست با دوربین و کیفیت عکس دست‌وپنجه نرم کند.
  • قابل ممیزی بودن پرونده — کد پیگیری ثبت احوال همراه پاسخ برمی‌گردد و می‌توانید آن را در سابقه پرونده نگه دارید.
  • کارکرد با کارت ملی صادرنشده — اگر مشتری هنوز کارت ملی هوشمند دریافت نکرده است، می‌توانید کد رهگیری را به‌جای سریال بفرستید.
  • مستقل از حضور کاربر — فراخوانی با توکن Client Credential انجام می‌شود و به تایید پیامکی مشتری در همان لحظه نیاز ندارد.
  • قابل ردیابی بودن هر فراخوانی — با شناسه پیگیری یکتا، هر درخواست در گزارش‌های شما و پیگیری‌های بعدی مشخص است.

چه چیزی از دریافت تصویر کارت ملی دریافت می‌کنید؟

جزئیات ورودی، خروجی و نمونه پاسخ در مستندات فنی آمده است.

جریان کار دریافت تصویر کارت ملی

  • ۱. ساخت کلاینت و گرفتن توکن — با اسکوپ facility:national-card-image:get توکن Client Credential بگیرید.
  • ۲. گردآوری ورودی‌ها — کد ملی، سریال کارت ملی و تاریخ تولد را در فرم ثبت‌نام یا از پرونده موجود مشتری بردارید.
  • ۳. فراخوانی سرویس — درخواست را همراه یک شناسه پیگیری یکتا بفرستید.
  • ۴. آماده‌سازی تصویر برای استفاده — تصویر دریافتی را در سمت خود به فایل تصویری تبدیل و در پرونده مشتری ذخیره کنید.
  • ۵. اتصال به قاعده کسب‌وکاری — تصویر را به مرحله بعدی احراز هویت (بازبینی کارشناس یا تطبیق چهره) بدهید و کد پیگیری را برای ممیزی نگه دارید.

نحوه شروع دریافت تصویر کارت ملی

این سرویس با رویکرد Client Credential (بدون رضایت پیامکی) فراخوانی می‌شود. اسکوپ مورد نیاز: facility:national-card-image:get. ابتدا کلاینت بسازید و توکن بگیرید: راهنمای شروع. سپس از مستندات فنی برای پیاده‌سازی استفاده کنید.

محدودیت‌ها و نکات دریافت تصویر کارت ملی

  • تاریخ تولد را در قالب yyyy/mm/dd بفرستید؛ تبدیل تاریخ ورودی کاربر به این قالب را در سمت خود انجام دهید.
  • اگر مشتری کارت ملی هوشمند خود را دریافت نکرده است، کد رهگیری را به‌جای سریال کارت ارسال کنید.
  • شناسه پیگیری اجباری است، حداکثر ۴۰ کاراکتر حرف و عدد می‌پذیرد و بهتر است UUID باشد.
  • تصویر به‌صورت داده متنی کدگذاری‌شده برمی‌گردد؛ پیش از نمایش یا بایگانی باید آن را به فایل تصویری تبدیل کنید و برای حجم پاسخ در سمت خود برنامه داشته باشید.
  • هر ناسازگاری میان سه ورودی (کد ملی، سریال و تاریخ تولد) مانع دریافت تصویر می‌شود؛ پیام خطای بازگشتی را به کاربر قابل‌فهم ترجمه کنید، نه اینکه خام نمایش دهید.
  • تصویر کارت ملی داده هویتی حساس است؛ آن را رمزنگاری‌شده نگه دارید، دسترسی را محدود کنید و مدت نگهداری را در سیاست داده خود مشخص کنید.

سوالات متداول دریافت تصویر کارت ملی

دریافت تصویر کارت ملی چیست؟

سرویسی است که با دریافت کد ملی، سریال کارت ملی و تاریخ تولد، تصویر کارت ملی همان شخص را همراه کد پیگیری ثبت احوال برمی‌گرداند تا در پرونده احراز هویت مشتری استفاده شود.

تفاوت این سرویس با خواندن اطلاعات کارت ملی با OCR چیست؟

جهت کار این دو متفاوت است: در این سرویس با اطلاعات هویتی، تصویر کارت را می‌گیرید؛ در خواندن اطلاعات کارت ملی با OCR تصویری که در اختیار دارید را می‌فرستید تا اطلاعات نوشته‌شده روی آن استخراج شود.

اگر مشتری کارت ملی هوشمند نداشته باشد چه کنیم؟

در این حالت کد رهگیری را به‌جای سریال کارت بفرستید.

آیا می‌توانم از تصویر این سرویس برای تطبیق چهره استفاده کنم؟

تصویر دریافتی می‌تواند مرجع پرونده شما باشد؛ برای سنجش انطباق چهره از سرویس‌های انطباق ویدئو و عکس کارت ملی یا انطباق ویدئو زنده با عکس کارت ملی استفاده کنید.

مستندات فنی این سرویس کجاست؟

صفحه مشخصات API شامل endpoint، پارامترها و نمونه پاسخ است.

چه نوع احراز هویتی لازم است؟

Grant type: client_credentials. جزئیات در راهنمای توکن.

آیا رضایت پیامکی کاربر لازم است؟

خیر. این سرویس با Client Credential و بدون رضایت پیامکی قابل فراخوانی است.

مستندات فنی دریافت تصویر کارت ملی

مشاهده مستندات فنی «دریافت تصویر کارت ملی» — endpoint، پارامترها، نمونه درخواست و پاسخ.

سرویس‌های مرتبط با دریافت تصویر کارت ملی