دسته «احراز هویت و شناخت مشتری» فینوتک ۱۹ سرویس برای راستیآزمایی هویت افراد دارد: از خواندن داده ثبت احوال تا تطبیق موبایل، کارت و شبا با کد ملی و سنجش شباهت نام. هر سرویس به یک پرسش مشخص پاسخ میدهد و خروجی آن یا داده ساختیافته است یا نتیجه یک تطبیق؛ تصمیم پذیرش یا رد همچنان در منطق کسبوکار شما گرفته میشود. این صفحه کمک میکند بدانید در هر مرحله از پرونده مشتری، کدام سرویس نقطه شروع درستی است.
درباره دسته احراز هویت و شناخت مشتری
سرویسهای این دسته در سه خانواده جای میگیرند. خانواده نخست، استعلام است: با کد ملی و تاریخ تولد، داده رسمی فرد خوانده میشود — مشخصات کامل ثبت احوال شامل شناسنامه و محل صدور، اطلاعات پایه کد ملی، وضعیت حیات، وضعیت نظام وظیفه، و برای اتباع غیرایرانی مشخصات سند شناسایی. خانواده دوم، تطبیق است: چیزی را که مشتری اظهار کرده یا در اختیار دارد — نام، شماره موبایل، شماره کارت یا شماره شبا — با کد ملی او میسنجد؛ خروجی یا نتیجه انطباق است یا میزان شباهت نام. خانواده سوم به مدرک و تصویر میپردازد: استخراج داده از تصویر کارت ملی، دریافت تصویر کارت ملی و انطباق ویدئوی کاربر با عکس کارت ملی. کنار این سه، استعلام ثبتنام در سامانه ثنای قوه قضائیه هم هست.
مرز این دسته، هویت شخص است. تبدیل شناسههای بانکی و استعلام بدهی مالیاتی موضوع دسته استعلام و تبدیل بانکی است و سابقه اعتباری، تسهیلات و چک برگشتی در دسته تسهیلات و اعتبارسنجی قرار دارد. اطلاعات ثبتی اشخاص حقوقی هم به دسته شناخت کسبوکار KYB مربوط است؛ تنها استثنا استعلام ثنا است که برای شخص حقوقی هم قابل فراخوانی است. هیچیک از سرویسهای این دسته امتیاز یا نمره هویتی نمیسازد و هیچیک جابهجایی وجه انجام نمیدهد.
کاربردهای کسبوکاری احراز هویت و شناخت مشتری
- افتتاح حساب و پذیرش غیرحضوری — پرونده هویتی با استعلام اطلاعات هویتی از داده رسمی ساخته میشود و مالکیت شماره موبایل با تطبیق شاهکار موبایل و کد ملی کنترل میگردد.
- کیف پول و ابزار پرداخت — پیش از اتصال کارت به حساب کاربری، تطبیق شماره کارت و کد ملی نشان میدهد کارت به همان شخص تعلق دارد.
- بیمه و خدمات درمانی — مشخصات بیمهشده و ذینفع پیش از صدور بیمهنامه یا پرداخت خسارت بررسی میشود و استعلام وضعیت حیات مانع پرداخت به پروندهای میشود که دیگر معتبر نیست.
- کسبوکارهایی با مشتری غیرایرانی — استعلام اتباع خارجی نام، ملیت و مشخصات سند شناسایی تبعه را برمیگرداند.
- استخدام و پذیرش نیرو — استعلام وضعیت نظام وظیفه وضعیت متقاضی را پیش از عقد قرارداد روشن میکند.
- قرارداد و پرونده حقوقی — استعلام ثنا نشان میدهد طرف قرارداد، حقیقی یا حقوقی، در سامانه ثنا ثبتنام کرده است یا نه.
- سنجش نام واردشده در فرم — احراز هویت با کد ملی میزان شباهت نام ارسالی را با صاحب واقعی کد ملی برمیگرداند.
انتخاب سرویس مناسب در احراز هویت و شناخت مشتری
- میخواهم بدانم یک کد ملی به چه کسی تعلق دارد — استعلام اطلاعات هویتی گستردهترین خروجی را دارد و مشخصات شناسنامه و محل صدور را هم میدهد؛ اگر نام، نام پدر و وضعیت حیات کافی است، استعلام کد ملی پاسخ سبکتری است.
- میخواهم ادعای مشتری را بسنجم، نه اینکه داده بخوانم — سرویسهای تطبیق نتیجه انطباق یا میزان شباهت را برمیگردانند: نام با احراز هویت با کد ملی، موبایل با تطبیق شاهکار موبایل و کد ملی، کارت با تطبیق شماره کارت و کد ملی یا تطبیق شماره کارت و شماره موبایل، و شبا با تطبیق شماره شبا و کد ملی. اگر میخواهید همزمان با تطبیق موبایل، پیامک تأیید هم برای کاربر ارسال شود، تطبیق موبایل و کد ملی با پیامک همین کار را میکند.
- تطبیق شبا را سختگیرانهتر میخواهم — تطبیق شماره شبا، کد ملی و تاریخ تولد تاریخ تولد را هم به شرط اضافه میکند و پاسخ آن بهجای دوحالتی، سطح اطمینان را مشخص میکند.
- کاربر باید ثابت کند خودش پشت دوربین است — انطباق ویدئو و عکس کارت ملی تشابه چهره را میسنجد؛ اگر نگرانی شما پخش عکس یا ویدئوی ضبطشده جلوی دوربین است، انطباق ویدئو زنده با عکس کارت ملی زنده بودن ویدئو و در صورت نیاز تشابه متن خواندهشده را هم بررسی میکند.
- فقط تصویر مدرک در اختیار دارم — خواندن اطلاعات کارت ملی با OCR داده روی و پشت کارت را از تصویر بیرون میکشد؛ مسیر معکوس آن دریافت تصویر کارت ملی است که با کد ملی، سریال کارت و تاریخ تولد، تصویر را برمیگرداند.
- باید رضایت خود کاربر ثبت شود — نسخههای پیامکی مانند استعلام کد ملی (Authorization SMS) و احراز هویت با کد ملی با پیامک همان خروجی نسخه Client Credential را میدهند، اما فراخوانی پس از تایید پیامکی کاربر انجام میشود.
- فقط یک نقطه را میخواهم کنترل کنم — برای وضعیت حیات، استعلام وضعیت حیات سرویس تخصصی همین کار است و لازم نیست برای آن استعلام هویتی کامل بگیرید.
شروع کار با احراز هویت و شناخت مشتری
برای فراخوانی هر سرویس این دسته به یک کلاینت و یک توکن معتبر نیاز دارید. مراحل ساخت کلاینت، درخواست اسکوپ و گرفتن توکن در راهنمای شروع آمده است؛ همانجا تفاوت جریانهای توکن هم توضیح داده شده است.
بیشتر سرویسهای این دسته با رویکرد Client Credential کار میکنند و به حضور یا تایید همزمان مشتری نیاز ندارند. استعلام کد ملی و احراز هویت با کد ملی نسخه Authorization SMS هم دارند که پس از دریافت اجازه دسترسی از کاربر فراخوانی میشود. اسکوپ دقیق، نشانی سرویس، پارامترها و نمونه پاسخ هر مورد در مستندات فنی همان سرویس آمده و از صفحه کسبوکاری آن قابل دسترسی است.
سوالات متداول احراز هویت و شناخت مشتری
این دسته دقیقا برای چه کاری است؟
برای اینکه پیش از ادامه دادن یک فرآیند، مطمئن شوید طرف مقابل همان کسی است که ادعا میکند. خروجی سرویسها یا داده هویتی رسمی است یا نتیجه سنجش داده اظهارشده با داده رسمی.
چه نوع توکنی لازم است؟
عمده سرویسها با توکن Client Credential فراخوانی میشوند. سرویسهایی که در نامشان به پیامک یا Authorization SMS اشاره شده، به توکن پیامکی نیاز دارند که پس از تایید کاربر صادر میشود.
تفاوت نسخه Client Credential و نسخه پیامکی چیست؟
خروجی یکسان است؛ تفاوت در این است که نسخه پیامکی پیش از فراخوانی، رضایت صریح کاربر را میگیرد. وقتی فرآیند شما باید نشان دهد استعلام با اطلاع صاحب داده انجام شده، نسخه پیامکی انتخاب درست است.
آیا همه سرویسها شبانهروزی در دسترساند؟
خیر. برای نمونه، استعلام کد ملی در تمام ساعات شبانهروز فعال است، اما استعلام وضعیت حیات و سرویسهای انطباق ویدئو در بازه شبانه یازده تا هفت صبح در دسترس نیستند. محدودیت هر سرویس در صفحه خودش نوشته شده است.
مستندات فنی هر سرویس کجاست؟
روی صفحه کسبوکاری هر سرویس در فهرست زیر، پیوند مستندات فنی آن آمده است؛ آنجا نشانی سرویس، پارامترهای ورودی، خروجی و نمونه پاسخ را میبینید.
نتیجه استعلام را چطور نگه داریم؟
داده هویتی، داده شخصی حساس است؛ فقط همان فیلدهایی را ذخیره کنید که فرآیند شما واقعا به آنها نیاز دارد، دسترسی را محدود نگه دارید و برای هر فراخوانی یک شناسه پیگیری یکتا ثبت کنید تا سوابق قابل ممیزی بماند.
فهرست سرویسهای احراز هویت و شناخت مشتری
- احراز هویت با کد ملی — احراز هویت با کد ملی؛ این سرویس کد ملی، تاریخ تولد و نام را دریافت میکند و شباهت نام ارسالشده را با نام واقعی صاحب کد ملی برمیگرداند. (مستندات فنی)
- احراز هویت با کد ملی با پیامک — احراز هویت با کد ملی؛ این سرویس کد ملی، تاریخ تولد و نام را دریافت میکند و شباهت نام ارسالشده را با نام واقعی صاحب کد ملی برمیگرداند. (مستندات فنی)
- استعلام اتباع خارجی — با وارد کردن شناسه تبعه و تاریخ تولد، اطلاعات هویتی فرد در خروجی نمایش داده میشود. (مستندات فنی)
- استعلام اطلاعات هویتی — این سرویس با دریافت کد ملی و تاریخ تولد، اطلاعات ثبت احوال را در خروجی نمایش میدهد. (مستندات فنی)
- استعلام ثنا — با وارد کردن کد شناسایی و نوع آن، نتیجه استعلام ثنا در سامانه قوه قضائیه برگردانده میشود. (مستندات فنی)
- استعلام کد ملی (Authorization SMS) — استعلام کد ملی — این سرویس کد ملی و تاریخ تولد دریافت میکند و اطلاعات ثبت احوال را برمیگرداند. (مستندات فنی)
- استعلام کد ملی (Client Credential) — استعلام کد ملی — این سرویس کد ملی و تاریخ تولد دریافت میکند و اطلاعات ثبت احوال را برمیگرداند. (مستندات فنی)
- استعلام وضعیت حیات — این سرویس با دریافت کد ملی و تاریخ تولد، وضعیت حیات (زنده یا مرده) را در خروجی نمایش میدهد. (مستندات فنی)
- استعلام وضعیت نظام وظیفه — با وارد کردن کد ملی و تاریخ تولد، وضعیت نظام وظیفه افراد مشخص میشود. (مستندات فنی)
- انطباق ویدئو زنده با عکس کارت ملی — این سرویس ویدیوی لایو کاربر، کد ملی، تاریخ تولد و سریال پشت کارت ملی هوشمند (یا کد رهگیری رسید کاغذی کارت ملی هوشمند) را دریافت میکند، ویدیو را با عکس کارت ملی تطبیق میدهد و لایو بودن آن را تایید یا رد میکند. (مستندات فنی)
- انطباق ویدئو و عکس کارت ملی — این سرویس ویدیوی کاربر، کد ملی، تاریخ تولد و سریال پشت کارت ملی هوشمند (یا کد رهگیری رسید کاغذی کارت ملی هوشمند) را دریافت میکند و ویدیوی ارسالی را با عکس کارت ملی چک میکند. (مستندات فنی)
- تطبیق شاهکار موبایل و کد ملی — برای تطبیق کد ملی و شماره موبایل از این سرویس استفاده کنید. (مستندات فنی)
- تطبیق شماره شبا و کد ملی — این سرویس با وارد کردن شماره شبا و کد ملی، تطبیق یا عدم تطبیق اطلاعات را در خروجی نمایش میدهد. (مستندات فنی)
- تطبیق شماره شبا، کد ملی و تاریخ تولد — این سرویس با وارد کردن شماره شبا، کد ملی و تاریخ تولد، تطبیق یا عدم تطبیق اطلاعات را در خروجی نمایش میدهد. (مستندات فنی)
- تطبیق شماره کارت و شماره موبایل — این سرویس با دریافت شماره موبایل و شماره کارت، تطابق آنها را بررسی میکند. (مستندات فنی)
- تطبیق شماره کارت و کد ملی — این سرویس با وارد کردن شماره کارت و کد ملی، تطبیق یا عدم تطبیق اطلاعات را در خروجی نمایش میدهد. (مستندات فنی)
- تطبیق موبایل و کد ملی با پیامک — این سرویس جهت تطبیق کد ملی و شماره موبایل و ارسال پیامک تأیید است. (مستندات فنی)
- خواندن اطلاعات کارت ملی با OCR — این سرویس برای دریافت اطلاعات روی و پشت کارت ملی است. (مستندات فنی)
- دریافت تصویر کارت ملی — با کد ملی، سریال کارت ملی و تاریخ تولد، عکس کارت ملی مشتری بازگردانده میشود. (مستندات فنی)