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