خطاهای استعلام هویتی و بانکی همیشه به معنی نادرست‌بودن اطلاعات کاربر نیستند. گاهی ورودی ناقص است، گاهی درخواست به دلیل دسترسی یا اعتبار حساب اجرا نمی‌شود و گاهی پاسخ قابل استفاده دریافت نشده است. حتی در یک درخواست موفق، نتیجه «عدم تطبیق» باید جدا از خطای فنی تفسیر شود. این راهنما یک مسیر عملی برای تشخیص دسته مشکل و جلوگیری از تصمیم‌گیری بر اساس پاسخ نامعتبر ارائه می‌کند.
سه وضعیت را در نرم‌افزار جدا نگه دارید
| وضعیت | معنی | رفتار مناسب |
|---|---|---|
| موفق و دارای نتیجه تطبیق | سرویس درخواست را بررسی کرده و نتیجه داده است | خواندن و استفاده از نتیجه طبق مستندات |
| موفق و دارای نتیجه عدم تطبیق | اطلاعات ارسال‌شده هماهنگ تشخیص داده نشده‌اند | درخواست اصلاح داده یا بررسی پرونده |
| خطا یا پاسخ نامشخص | برای تصمیم، نتیجه معتبر در دسترس نیست | نمایش وضعیت بررسی‌نشده و پیگیری علت |
در نمونه پاسخ خدمات تطبیق شناسار، نتیجه در فیلد matched قرار دارد. اما پیش از خواندن آن باید وضعیت کلی درخواست کنترل شود. نبود این فیلد یا پاسخ ناقص را به false تبدیل نکنید؛ چنین تبدیلی می‌تواند خطای سرویس را به عدم تطبیق هویت تبدیل کند.
مرحله اول: ورودی را بررسی کنید
- عددهای فارسی و عربی را در صورت نیاز به رقم‌های استاندارد تبدیل کنید.
- فاصله، خط تیره یا نویسه اضافی را طبق قواعد ورودی حذف کنید.
- کد ملی و شماره‌های بانکی را رشته نگه دارید تا صفر ابتدایی حذف نشود.
- تاریخ تولد را کامل و در قالب دقیق مستندات ارسال کنید.
- فیلدهای لازم همان سرویس را بررسی کنید؛ ورودی سرویس مشابه را کپی نکنید.
برای شاهکار، شماره موبایل و کد ملی لازم است. تطبیق کارت تاریخ تولد هم دریافت می‌کند، ولی تطبیق شبا با کد ملی و شبا انجام می‌شود. استعلام شرکت نیز شناسه ملی شرکت می‌خواهد، نه کد ملی نماینده.
کنترل قالب، جلوی بخشی از درخواست‌های اشتباه را می‌گیرد؛ اما معتبر‌بودن شکل یک شماره به معنای تأیید هویت یا مالکیت نیست.
مرحله دوم: دسترسی و شرایط حساب را کنترل کنید
اگر ورودی کامل است، فعال‌بودن سرویس در حساب، اعتبار کلید وب‌سرویس و شرایط استفاده را بررسی کنید. پیام و کد پاسخ را با مستندات سرویس تطبیق دهید. برای خطای دسترسی، تغییر تاریخ تولد یا شماره کارت راه‌حل مناسبی نیست.
اگر کلید باید اصلاح شود، این کار را فقط در محل امن پیکربندی نرم‌افزار انجام دهید. کلید API را در تصویر گزارش، مقاله، دیدگاه یا گفت‌وگوی عمومی ارسال نکنید. اطلاعات قابل نمایش به کاربر با اطلاعات فنی لازم برای تیم توسعه یکسان نیست.
مرحله سوم: پاسخ نامشخص و اختلال را مدیریت کنید
قطع اتصال، پایان مهلت پاسخ و پاسخ ناقص را از نتیجه عدم تطبیق جدا کنید. تا زمانی که نتیجه معتبر در دسترس نیست، به‌صورت خودکار موفقیت یا شکست هویتی اعلام نکنید. برای کاربر، پیام کوتاه و متناسب با وضعیت واقعی نشان دهید؛ برای نمونه «نتیجه بررسی دریافت نشد؛ لطفاً بعداً دوباره تلاش کنید».
تلاش مجدد باید محدود و متناسب با نوع خطا باشد. درخواست‌های پیاپی و بدون فاصله می‌توانند بار اضافی ایجاد کنند و پیگیری را دشوار کنند. پیش از تکرار درخواست با نتیجه نامشخص، گزارش پنل یا شناسه پیگیری موجود را بررسی کنید تا بتوانید وضعیت درخواست قبلی را تشخیص دهید.
اگر درخواست موفق است ولی تطبیق انجام نمی‌شود
اطلاعات همان درخواست را از نظر ورود اشتباه بررسی کنید. شماره موبایل یا اطلاعات بانکی متعلق به شخص دیگر، حتی اگر فرد به آن دسترسی داشته باشد، لزوماً با کد ملی صاحب پروفایل تطبیق ندارد. از کاربر بخواهید اطلاعات مربوط به خودش را بررسی کند؛ علت قطعی را بدون شواهد اعلام نکنید.
در سامانه‌هایی که پرونده باید بررسی انسانی شود، نتیجه و اطلاعات ضروری را برای اپراتور مجاز آماده کنید. عدم تطبیق را به‌تنهایی اتهام تقلب ندانید و داده‌های جدید را بدون استعلام مجدد، با نتیجه قدیمی تأیید نکنید.
برای پیگیری چه اطلاعاتی نگه داریم؟
- نام سرویس و زمان ارسال درخواست.
- شناسه درخواست یا پیگیری، اگر در پاسخ یا گزارش پنل موجود است.
- کد و پیام خطا و وضعیت کلی پاسخ.
- نسخه نرم‌افزار یا مرحله‌ای از فرایند که خطا در آن رخ داده است.
- شرح کوتاه اقدام انجام‌شده و اینکه آیا درخواست تکرار شده است.
نیازی نیست همه اطلاعات حساس کاربر را در هر گزارش تکرار کنید. شماره کامل کارت، کد ملی، شبا و کلید دسترسی را در خروجی‌های عمومی قرار ندهید. برای بررسی فنی قالب درخواست و کدهای خطا، مستندات همان سرویس مرجع اصلی است.
پرسش‌های رایج
آیا خطای سرویس یعنی هویت کاربر معتبر نیست؟
خیر. خطا یعنی نتیجه قابل استفاده دریافت نشده است؛ اعتبار هویت از چنین وضعیتی قابل نتیجه‌گیری نیست.
آیا هر خطا را باید با تلاش مجدد حل کرد؟
خیر. خطای قالب یا دسترسی معمولاً ابتدا به اصلاح علت نیاز دارد. تکرار همان درخواست نامعتبر مشکل را رفع نمی‌کند.
از کجا به مستندات هر سرویس برسیم؟
در فهرست خدمات شناسار، صفحه هر سرویس و مسیر مستندات آن مشخص است.
(Share) کلیک کنید.
(Add to home screen) را انتخاب کنید.