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