API استعلام تسهیلات فعال بانکی

استعلام تسهیلات فعال بانکی یک ورودی دارد، nationalCode، و یک خلاصه برمی‌گرداند: تعداد تسهیلات فعال، نام و نام خانوادگی، مجموع مبلغ تسهیلات، مانده، ماندهٔ سررسیدگذشته، ماندهٔ معوق، ماندهٔ مشکوک‌الوصول و تسهیلات یا تعهدات برگشتی. تصویری یک‌خطی از بار بدهی بانکی یک نفر، بی آنکه فهرست تک‌تک وام‌ها بیاید.

این خدمت فقط از API کسب‌وکارها ارائه می‌شود و روی سایت احرازینو نیست. دلیلش همان ورودی است: کد ملی به‌تنهایی کافی است و صاحب آن نه پیامکی می‌گیرد و نه چیزی را تأیید می‌کند. گرفتن رضایت مشتری پیش از هر فراخوان، مسئولیت کسب‌وکاری است که API را به کار می‌گیرد، و این رضایت باید در قرارداد و فرم‌های خود شما ثبت شده باشد.

تفاوت با گزارش اعتبارسنجی

گزارش اعتبارسنجی رتبه و سابقهٔ کامل اعتباری را می‌دهد و فقط با تأیید پیامکی خود شخص اجرا می‌شود. این استعلام نه رتبه دارد و نه تأیید پیامکی، و فقط خلاصهٔ تسهیلاتی را می‌دهد که امروز باز است. اگر تصمیمتان به سابقهٔ بازپرداخت یا رتبه نیاز دارد، این جایگزین آن نیست.

آنچه این استعلام نمی‌کند

فهرست تک‌تک تسهیلات، نام بانک، نوع وام، قسط ماهانه و تاریخ سررسید را نمی‌دهد. تسهیلات تسویه‌شده هم در آن نیست؛ فقط آنچه فعال است. چک برگشتی و رنگ چک هم استعلام‌های جداگانه‌اند.

نکته پیاده‌سازی

count همیشه در پاسخ هست و وقتی تسهیلات فعالی ثبت نیست، صفر است. این پاسخ معتبر است و هزینه دارد؛ آن را با «اطلاعات در دسترس نیست» یکی نکنید.

مبلغ‌ها در کلیدهایی مثل loans_total_amount، loans_debt_amount و loans_past_due_amount عدد خام‌اند؛ همان‌طور ذخیره‌شان کنید. برای قاعدهٔ تصمیم، نسبت‌ها گویاتر از عدد مطلق‌اند: سهم ماندهٔ معوق و مشکوک‌الوصول از کل مانده نشان می‌دهد بدهی چقدر گرفتار است.