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