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