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