سرویس «احراز هویت با کد ملی» در دسته استعلام و تبدیل بانکی فینوتک با دریافت کد ملی و تاریخ تولد، میزان شباهت نامی را که شما فرستادهاید با نام واقعی صاحب همان کد ملی برمیگرداند و وضعیت حیات او را مشخص میکند. با این عدد شباهت میتوانید بهجای تصمیم دوحالته «درست یا غلط»، آستانه تعریف کنید و پروندههای مرزی را به بررسی دستی بفرستید.
احراز هویت با کد ملی چه مشکلی را حل میکند؟
در فرمهای ثبتنام، نام و نام خانوادگی را کاربر تایپ میکند و همینجا انبوهی از اختلافهای کوچک ساخته میشود: نیمفاصله جا میافتد، نام خانوادگی مرکب بهصورت جدا نوشته میشود، «ي» و «ك» عربی وارد میشود یا نام کامل در جای نام کوچک قرار میگیرد. اگر سامانه شما فقط تطبیق کامل رشتهها را بپذیرد، کاربران واقعی رد میشوند و اگر اصلاً تطبیق نکند، پروندهها با اطلاعات هویتی نادرست جلو میروند و مشکل در مرحله پرداخت یا ممیزی خود را نشان میدهد.
این سرویس بهجای پاسخ صفر و یک، برای هر بخش نام یک درجه شباهت بین ۰ تا ۱۰۰ برمیگرداند و در کنار آن، تطبیق نام پدر و جنسیت و وضعیت حیات صاحب کد ملی را هم گزارش میکند. سامانه شما میتواند بر اساس آستانهای که خودتان تعیین میکنید تصمیم بگیرد: بالاتر از حد مشخص تایید خودکار، در محدوده میانی ارجاع به کارشناس و پایینتر از آن رد. چون فراخوانی با Client Credential انجام میشود، این بررسی در فرآیندهای پشتصحنه و روی پروندههای انباشته هم قابل اجراست.
کاربردهای احراز هویت با کد ملی
- پذیرش مشتری در خدمات مالی و اعتباری — نام و کد ملی متقاضی پیش از ادامه پرونده اعتبارسنجی راستیآزمایی میشود.
- پاکسازی پایگاه داده مشتریان قدیمی — رکوردهای انباشته با نامهای تایپی بازبینی و موارد مشکوک برای اصلاح علامتگذاری میشوند.
- بررسی فهرست ذینفعان پیش از پرداخت گروهی — در پرداخت خسارت، جایزه یا کمکهزینه، تطبیق نام با کد ملی پیش از صدور دستور پرداخت انجام میشود.
- کنترل اطلاعات طرف قرارداد در فرآیندهای اداری — شرکتهای خدماتی و پیمانکاری صحت هویت افراد را پیش از انعقاد قرارداد بررسی میکنند.
- کاهش ثبتنامهای جعلی در پلتفرمهای دیجیتال — نام و کد ملی ناسازگار در همان مرحله ثبتنام شناسایی میشود.
- بازبینی دورهای پروندههای فعال — وضعیت حیات و صحت اطلاعات هویتی مشتریان قدیمی در بازبینی ادواری کنترل میشود.
مزایای احراز هویت با کد ملی
- نتیجه درجهبندیشده بهجای پاسخ دوحالته — میتوانید آستانه تایید، بررسی دستی و رد را متناسب با ریسک محصول خود تنظیم کنید.
- انعطاف در ارسال نام — نام را هم میتوانید بهصورت یک قلم کامل بفرستید و هم بهصورت نام و نام خانوادگی جدا.
- کنترلهای تکمیلی هویتی — جنسیت، نام پدر و وضعیت حیات هم در همان پاسخ بررسی میشوند.
- اجرا بدون حضور کاربر — پروندههای پسزمینه و رکوردهای قدیمی هم قابل بررسیاند، چون به اقدام کاربر در لحظه نیاز نیست.
- کد پیگیری برای مستندسازی — پاسخ کد پیگیری دارد و میتوانید نتیجه را در سوابق پرونده مستند کنید.
چه چیزی از احراز هویت با کد ملی دریافت میکنید؟
جزئیات ورودی، خروجی و نمونه پاسخ در مستندات فنی آمده است.
جریان کار احراز هویت با کد ملی
- ۱. گرفتن توکن — با اسکوپ
facility:cc-nid-verification:getتوکن Client Credential دریافت کنید. - ۲. ارسال کد ملی و تاریخ تولد — کد ملی مورد بررسی و تاریخ تولد صاحب آن را به همراه یک
trackIdیکتا بفرستید. - ۳. افزودن اقلام تطبیق — نام، نام خانوادگی یا نام کامل و در صورت نیاز نام پدر و جنسیت را به درخواست اضافه کنید.
- ۴. خواندن درجه شباهت — عددهای شباهت و وضعیت حیات را از پاسخ بردارید.
- ۵. اعمال آستانه و ثبت نتیجه — بر اساس آستانه تعریفشده تصمیم بگیرید و نتیجه را همراه کد پیگیری در پرونده ذخیره کنید.
نحوه شروع احراز هویت با کد ملی
این سرویس با رویکرد Client Credential (بدون رضایت پیامکی) فراخوانی میشود. اسکوپ مورد نیاز: facility:cc-nid-verification:get. ابتدا کلاینت بسازید و توکن بگیرید: راهنمای شروع. سپس از مستندات فنی برای پیادهسازی استفاده کنید.
محدودیتها و نکات احراز هویت با کد ملی
- پارامترهای متنی درخواست باید encode شده ارسال شوند؛ نامهای فارسی بدون این کار بهدرستی به سرویس نمیرسند.
- برای دیدن درجه شباهت، دستکم یکی از اقلام نام کامل، نام یا نام خانوادگی را بفرستید؛ با ارسال تنها کد ملی و تاریخ تولد، تطبیق نامی انجام نمیشود.
- تاریخ تولد از ورودیهای اجباری است و باید با قالب اعلامشده در مستندات فنی ارسال شود.
- آستانه پذیرش شباهت را خودتان و متناسب با ریسک فرآیند تعیین کنید؛ عدد شباهت یک سنجه است، نه تصمیم نهایی.
- پیش از ارسال، نامها را نرمالسازی کنید تا اختلافهای نگارشی بیدلیل نمره شباهت را پایین نیاورد.
- خروجی شامل دادههای هویتی است؛ آن را فقط برای همان هدف مشخص نگه دارید و دسترسی به آن را محدود کنید.
سوالات متداول احراز هویت با کد ملی
احراز هویت با کد ملی چیست؟
سرویسی است که کد ملی، تاریخ تولد و نام را میگیرد و میزان شباهت نام ارسالی با نام واقعی صاحب کد ملی را همراه با وضعیت حیات و کد پیگیری برمیگرداند.
تفاوت این سرویس با نسخه پیامکی چیست؟
در این نسخه فراخوانی با توکن Client Credential و بدون دخالت کاربر انجام میشود؛ اگر جریان کاری شما به رضایت صریح خود شخص نیاز دارد، از احراز هویت با کد ملی با پیامک استفاده کنید.
درجه شباهت یعنی چه؟
بهجای پاسخ بله و خیر، برای هر قلم نامی عددی بین ۰ تا ۱۰۰ برمیگردد که نشان میدهد مقدار ارسالی چقدر به مقدار واقعی نزدیک است.
چه اطلاعاتی را باید حتماً بفرستم؟
کد ملی و تاریخ تولد اجباری هستند و برای مشاهده تطبیق نامی، دستکم یکی از اقلام نام باید همراه درخواست ارسال شود.
آیا وضعیت حیات فرد هم مشخص میشود؟
بله. وضعیت حیات صاحب کد ملی در پاسخ میآید و میتوانید آن را در قواعد پذیرش و بازبینی پرونده به کار ببرید.
مستندات فنی این سرویس کجاست؟
صفحه مشخصات API شامل endpoint، پارامترها و نمونه پاسخ است.
چه نوع احراز هویتی لازم است؟
Grant type: client_credentials. جزئیات در راهنمای توکن.
آیا رضایت پیامکی کاربر لازم است؟
خیر. این سرویس با Client Credential و بدون رضایت پیامکی قابل فراخوانی است.
مستندات فنی احراز هویت با کد ملی
مشاهده مستندات فنی «احراز هویت با کد ملی» — endpoint، پارامترها، نمونه درخواست و پاسخ.