سرویس «استعلام اطلاعات هویتی» در دسته احراز هویت و شناخت مشتری فینوتک، با گرفتن کد ملی و تاریخ تولد، اطلاعات ثبت احوال فرد شامل نام و نام خانوادگی، نام پدر، جنسیت، مشخصات شناسنامه، محل صدور و وضعیت حیات را برمیگرداند. با این داده میتوانید اظهار مشتری را در همان لحظه راستیآزمایی کنید و پرونده هویتی او را بدون دریافت تصویر مدرک کامل کنید.
استعلام اطلاعات هویتی چه مشکلی را حل میکند؟
پرونده هویتی مشتری معمولا از روی چیزی ساخته میشود که خود او در فرم تایپ کرده است؛ نامی که ممکن است با نگارش متفاوت وارد شده باشد، نام پدری که غلط تایپ شده، یا مشخصات شناسنامهای که از روی تصویری کمکیفیت خوانده شده است. این داده ناهمگون بعدا در تطبیق با سایر سامانهها، صدور قرارداد و گزارشهای انطباق دردسر میسازد و اصلاح آن به تماس با مشتری و بازگشت به مرحله قبل نیاز دارد.
این سرویس مرجع داده هویتی را جابهجا میکند: با کد ملی و تاریخ تولد، اطلاعات ثبت احوال بهصورت ساختیافته دریافت میشود و پرونده بهجای اظهار کاربر، بر اساس همین داده ساخته میشود. وضعیت حیات و کد رهگیری ثبت احوال هم در همان پاسخ میآید، بنابراین با یک فراخوانی هم پرونده تکمیل میشود و هم شواهد لازم برای ممیزی ثبت میگردد.
کاربردهای استعلام اطلاعات هویتی
- تکمیل خودکار فرم ثبتنام — پس از دریافت کد ملی و تاریخ تولد، فیلدهای هویتی با داده رسمی پر میشوند و کاربر فقط تایید میکند.
- صدور قرارداد و اسناد رسمی — مشخصات شناسنامه و محل صدور برای درج در قرارداد، تعهدنامه و اسناد مالی از منبع ساختیافته برداشته میشود.
- پذیرش مشتری در خدمات مالی و اعتباری — پیش از تشکیل پرونده تسهیلات یا خرید اقساطی، صحت اطلاعات هویتی متقاضی کنترل میشود.
- تطبیق و پاکسازی پایگاه مشتریان — رکوردهای قدیمی که دستی وارد شدهاند با داده رسمی مقایسه و یکدست میشوند.
- پروندههای بیمهای و درمانی — مشخصات بیمهشده و ذینفع پیش از صدور بیمهنامه یا پرداخت خسارت راستیآزمایی میشود.
- کنترلهای انطباق و شناخت مشتری — پرونده هویتی با داده رسمی و کد رهگیری ثبت میشود و در بازرسی قابل استناد است.
مزایای استعلام اطلاعات هویتی
- پوشش گسترده اطلاعات هویتی در یک فراخوانی — نام، نام خانوادگی، نام پدر، جنسیت، مشخصات شناسنامه و محل صدور با هم برمیگردند.
- وضعیت حیات در همان پاسخ — نیازی نیست برای تشخیص فوت فرد، فراخوانی جداگانهای به جریان اضافه کنید.
- کد رهگیری ثبت احوال برای مستندسازی — هر استعلام شناسه قابل استناد دارد و میتوانید آن را در پرونده نگه دارید.
- کاهش خطای ورود داده — بهجای تایپ دستی مشخصات از روی تصویر مدرک، داده مستقیم در سامانه مینشیند.
- بدون نیاز به همکاری همزمان مشتری — فراخوانی با توکن Client Credential انجام میشود و به تایید پیامکی نیاز ندارد.
چه چیزی از استعلام اطلاعات هویتی دریافت میکنید؟
جزئیات ورودی، خروجی و نمونه پاسخ در مستندات فنی آمده است.
جریان کار استعلام اطلاعات هویتی
- ۱. ساخت کلاینت و گرفتن توکن — با اسکوپ
kyc:identification-inquiry:getتوکن Client Credential بگیرید. - ۲. دریافت کد ملی و تاریخ تولد — این دو ورودی را در فرم ثبتنام یا از پرونده موجود مشتری بردارید.
- ۳. فراخوانی استعلام — درخواست را با یک شناسه پیگیری یکتا ارسال کنید.
- ۴. تطبیق با اظهار کاربر و تکمیل پرونده — داده بازگشتی را با آنچه کاربر وارد کرده مقایسه و فیلدهای هویتی پرونده را با داده رسمی پر کنید.
- ۵. ثبت شواهد — نتیجه استعلام، کد رهگیری ثبت احوال و شناسه پیگیری را برای ممیزی ذخیره کنید.
نحوه شروع استعلام اطلاعات هویتی
این سرویس با رویکرد Client Credential (بدون رضایت پیامکی) فراخوانی میشود. اسکوپ مورد نیاز: kyc:identification-inquiry:get. ابتدا کلاینت بسازید و توکن بگیرید: راهنمای شروع. سپس از مستندات فنی برای پیادهسازی استفاده کنید.
محدودیتها و نکات استعلام اطلاعات هویتی
- تاریخ تولد باید در قالب
yyyy/mm/ddارسال شود و با کد ملی همان فرد بخواند؛ در غیر این صورت استعلام به نتیجه معتبر نمیرسد. - وضعیت درخواست را در پاسخ نادیده نگیرید؛ پیش از استفاده از داده هویتی، موفق بودن استعلام را در منطق خود بررسی کنید.
- در تطبیق نام با داده موجود در سامانه خود، تفاوتهای نگارشی مانند نیمفاصله و حروف عربی «ي» و «ك» را نرمالسازی کنید.
- نتیجه، تصویری از همان لحظه است؛ برای پروندههای بلندمدت، بازبینی دورهای را در فرآیند خود پیشبینی کنید.
- برای هر فراخوانی شناسه پیگیری یکتا بفرستید تا پیگیری خطا و تطبیق سوابق ساده شود.
- داده هویتی و مشخصات شناسنامه، داده حساس شخصی است؛ فقط فیلدهایی را ذخیره کنید که واقعا به آنها نیاز دارید و دسترسی را محدود نگه دارید.
سوالات متداول استعلام اطلاعات هویتی
استعلام اطلاعات هویتی چیست؟
سرویسی است که با دریافت کد ملی و تاریخ تولد، اطلاعات ثبت احوال فرد شامل نام، نام خانوادگی، نام پدر، جنسیت، مشخصات شناسنامه، محل صدور و وضعیت حیات را بهصورت داده ساختیافته برمیگرداند.
تفاوت این سرویس با استعلام کد ملی چیست؟
دامنه خروجی این سرویس گستردهتر است و مشخصات شناسنامه و محل صدور را هم شامل میشود؛ اگر فقط به تایید هویت پایه نیاز دارید، استعلام کد ملی کافی است.
آیا وضعیت حیات هم در خروجی هست؟
بله؛ وضعیت حیات بخشی از پاسخ این سرویس است. اگر تنها به همین مورد نیاز دارید، استعلام وضعیت حیات سرویس تخصصی آن است.
آیا مشخصات شناسنامه هم برمیگردد؟
بله؛ شماره، سری و سریال شناسنامه بههمراه محل صدور در پاسخ میآید. شرح دقیق خروجی در مستندات فنی آمده است.
مستندات فنی این سرویس کجاست؟
صفحه مشخصات API شامل endpoint، پارامترها و نمونه پاسخ است.
چه نوع احراز هویتی لازم است؟
Grant type: client_credentials. جزئیات در راهنمای توکن.
آیا رضایت پیامکی کاربر لازم است؟
خیر. این سرویس با Client Credential و بدون رضایت پیامکی قابل فراخوانی است.
مستندات فنی استعلام اطلاعات هویتی
مشاهده مستندات فنی «استعلام اطلاعات هویتی» — endpoint، پارامترها، نمونه درخواست و پاسخ.