دسته «تسهیلات و اعتبارسنجی» فینوتک ۱۹ سرویس برای خواندن سابقه تسهیلات، چک برگشتی، رنگ چک، ضمانتنامه و گزارش اعتباری دارد. خروجی این دسته داده ساختیافته برای تصمیم اعطا، رد یا سقف اعتبار است؛ خود وام یا ضمانتنامه صادر نمیشود.
درباره دسته تسهیلات و اعتبارسنجی
سرویسهای این دسته در چند خانواده جای میگیرند. خانواده نخست، تسهیلات جاری است: با کد ملی شخص حقیقی یا شناسه ملی شخص حقوقی، مجموع تعهد بانکی، مانده بدهی، مانده معوق و مشکوکالوصول و فهرست تسهیلات خوانده میشود. خانواده دوم، سابقه ایفای تعهد چکی است: فهرست چکهای برگشتی، یا خلاصه همان سابقه در قالب کد رنگ پنجسطحی. خانواده سوم به ضمانتنامه میپردازد: جزئیات یک سند ضمانت، وثایق متصل به آن، و فهرستی از وامهایی که شخص در آنها ضامن است. کنار اینها، گزارش اعتباری دومرحلهای، استعلام مکنا، و اعتبار معاملاتی سهمرحلهای قرار دارد.
مرز این دسته، ریسک اعتباری است نه هویت. راستیآزمایی کد ملی، موبایل و مدرک در دسته احراز هویت و شناخت مشتری است و وضعیت یک برگه چک صیادی مشخص — ثبت، انتقال یا لغو آن — در دسته چک صیادی. اطلاعات ثبتی شرکت هم به دسته شناخت کسبوکار KYB مربوط است؛ اینجا فقط بار تعهد و سابقه بدقولی همان شخصیت حقوقی خوانده میشود. هیچیک از این APIها تسهیلات، ضمانتنامه یا نمره اعتباری جدید صادر نمیکنند و تصمیم پذیرش همچنان در منطق شما گرفته میشود.
کاربردهای کسبوکاری تسهیلات و اعتبارسنجی
- وامدهی خرد و فروش اقساطی — پیش از عقد قرارداد، بار تسهیلات متقاضی با استعلام تسهیلات و سابقه چک با استعلام چک برگشتی دیده میشود.
- پذیرش چک بهعنوان وثیقه یا ابزار پرداخت — استعلام وضعیت رنگ چک تصمیم قبول یا رد را به یک قاعده پنجسطحی تبدیل میکند. برای شرکت استعلام وضعیت رنگ چک حقوقی و اگر رضایت پیامکی لازم است وضعیت رنگ چک پیامکی همان کد را میدهد.
- اعتبار تجاری به شرکت — تسهیلات و چک برگشتی شخص حقوقی با استعلام تسهیلات جاری حقوقی و استعلام چک برگشتی حقوقی بررسی میشود.
- اتکا به ضمانتنامه بانکی — اعتبار سند با اطلاعات ضمانت نامه و پشتوانه آن با وثایق و تضامین ضمانت نامه کنترل میگردد.
- پرونده اعتباری کامل متقاضی — گزارش تفصیلی با ثبت درخواست JSON یا ثبت درخواست PDF آغاز و در مرحله دریافت نتیجه خوانده میشود.
- معاملات و نقلوانتقال با ریسک حقوقی — وضعیت محکومیت مالی یا ممنوعالمعامله در پایان جریان استعلام اعتبار معاملاتی مشخص میشود.
- سنجش تعهد ضمانتی متقاضی — وامهایی که شخص در آنها ضامن است با استعلام ضمانت های فرد با پیامک به پرونده اضافه میشود.
انتخاب سرویس مناسب در تسهیلات و اعتبارسنجی
- تسهیلات جاری را میخواهم، نه گزارش کامل — برای شخص حقیقی استعلام تسهیلات و برای شرکت استعلام تسهیلات جاری حقوقی. اگر رضایت پیامکی لازم است، استعلام پیامکی تسهیلات همان داده را پس از تایید کاربر میدهد.
- سابقه چک برگشتی را با جزئیات میخواهم — استعلام چک برگشتی، برای شرکت استعلام چک برگشتی حقوقی، و با رضایت پیامکی استعلام پیامکی چک برگشتی.
- فقط یک کد رنگ برای قاعده پذیرش چک میخواهم — استعلام وضعیت رنگ چک برای حقیقی یا شناسه صیاد، استعلام وضعیت رنگ چک حقوقی برای شناسه ملی شرکت، و وضعیت رنگ چک پیامکی پس از تایید کاربر برای حقیقی یا حقوقی.
- گزارش اعتباری کامل میخواهم — مسیر دومرحلهای پیامکی: ابتدا ثبت درخواست JSON یا ثبت درخواست PDF، سپس گزارش اعتباری (مرحله ۲) — دریافت نتیجه. متن گزارش در مرحله اول برنمیگردد. قالب خروجی در همان ثبت انتخاب میشود.
- ضمانتنامه در دست دارم — از اطلاعات ضمانت نامه شروع کنید؛ اگر پشتوانه سند هم مهم است، وثایق و تضامین ضمانت نامه را هم بخوانید. تعهد ضمانتی خود شخص در استعلام ضمانت های فرد با پیامک میآید.
- میخواهم بدانم طرف معامله ممنوعالمعامله است یا نه — جریان سهمرحلهای: استعلام اعتبار معاملاتی (مرحله ۱) — درخواست، صحتسنجی OTP، سپس دریافت گزارش.
- مکنا را جدا میخواهم — استعلام مکنا همین بخش پرونده را بدون گزارش کامل برمیگرداند.
شروع کار با تسهیلات و اعتبارسنجی
برای فراخوانی، کلاینت بسازید و توکن بگیرید؛ مسیر در راهنمای شروع آمده است. بخشی از سرویسها با رویکرد Client Credential و بدون تایید همزمان مشتری کار میکنند و بخشی — گزارش اعتباری، نسخههای پیامکی تسهیلات و چک، و ضمانتهای فرد — توکن Authorization SMS میخواهند. اعتبار معاملاتی با توکن Client Credential فراخوانی میشود، اما همکاری خود شخص در قالب رمز یکبار مصرف داخل همان جریان ثبت میگردد.
اسکوپ دقیق، ورودی و نمونه پاسخ هر مورد در مستندات فنی همان سرویس است و از صفحه کسبوکاری آن در فهرست پایین همین صفحه قابل دسترسی است. داده اعتباری حساس است؛ فقط فیلد لازم را نگه دارید و برای هر فراخوانی شناسه پیگیری یکتا بفرستید.
سوالات متداول تسهیلات و اعتبارسنجی
این دسته دقیقا برای چه کاری است؟
برای دیدن بار تعهد بانکی، سابقه چک، ضمانتنامه و گزارش اعتباری پیش از تصمیم مالی. خروجی، داده برای موتور تصمیم شماست نه صدور تسهیلات.
چه نوع توکنی لازم است؟
بسیاری از استعلامها با توکن Client Credential فراخوانی میشوند. سرویسهایی که در نامشان پیامک یا گزارش اعتباری آمده، معمولاً توکن Authorization SMS میخواهند. جزئیات در راهنمای شروع.
تفاوت استعلام تسهیلات با گزارش اعتباری چیست؟
استعلام تسهیلات، تعهد جاری در بانکها را برمیگرداند. گزارش اعتباری یک پردازش دومرحلهای است و پس از تایید پیامکی کاربر، گزارش کاملتری برای تصمیمگیری در اختیار میگذارد.
رنگ چک همان فهرست چک برگشتی است؟
خیر. فهرست چک برگشتی جزئیات برگهها را میدهد؛ رنگ چک همان سابقه را در یک مقیاس پنجسطحی خلاصه میکند تا قاعده پذیرش سادهتر شود.
نتیجه استعلام تا کی معتبر است؟
پاسخ، تصویر همان لحظه از پرونده اعتباری است. برای تصمیم تازه یا پروندههای ذخیرهشده، استعلام را دوباره بگیرید.
مستندات فنی هر سرویس کجاست؟
صفحه کسبوکاری هر سرویس در فهرست پایین، پیوند مستندات فنی همان عملیات را دارد.
فهرست سرویسهای تسهیلات و اعتبارسنجی
- استعلام اعتبار معاملاتی (مرحله ۱) — درخواست — با وارد کردن شماره موبایل و کد ملی، رمز یکبار مصرف جهت استعلام اعتبار معاملاتی افراد ارسال میشود. (مستندات فنی)
- استعلام اعتبار معاملاتی (مرحله ۲) — صحتسنجی OTP — با وارد کردن کد یکبارمصرف و inquiryTrackId دریافتی از مرحله درخواست، صحت OTP بررسی میشود. (مستندات فنی)
- استعلام اعتبار معاملاتی (مرحله ۳) — دریافت گزارش — با inquiryTrackId دریافتی از مرحله صحتسنجی، وضعیت موثر و محکومیتهای مالی شخص برگردانده میشود. (مستندات فنی)
- استعلام پیامکی تسهیلات — تسهیلات جاری مشتری را با تایید پیامکی از همه بانکها برمیگرداند. (مستندات فنی)
- استعلام پیامکی چک برگشتی — چکهای برگشتی همه بانکها را با تایید پیامکی برمیگرداند. (مستندات فنی)
- استعلام تسهیلات — تسهیلات جاری مشتری را برمی گرداند(تسهیلات همه بانکها) (مستندات فنی)
- استعلام تسهیلات جاری حقوقی — تسهیلات جاری حقوقی را برمی گرداند(تسهیلات همه بانکها) (مستندات فنی)
- استعلام چک برگشتی — چکهای برگشتی (همه بانکها ) مشتری را برمیگرداند. (مستندات فنی)
- استعلام چک برگشتی حقوقی — با دریافت شناسه ملی، چک های برگشتی را در خروجی نمایش می دهد. (مستندات فنی)
- استعلام ضمانت های فرد با پیامک — این سرویس با وارد کردن کد ملی یا شناسه ملی، فهرست وامهایی را برمیگرداند که شخص بهعنوان ضامن در آنها ثبت شده است (شامل مشخصات بدهکار، مبلغ و شعبه بانک). (مستندات فنی)
- استعلام مکنا — با وارد کردن کد ملی، مانده و سوابق مکنا (کد مکنا، مانده ایران/بانک و تاریخها) برگردانده میشود. (مستندات فنی)
- استعلام وضعیت رنگ چک — در این سرویس، با وارد کردن شناسه ملی و یا شناسه صیاد، درخروجی کد رنگ چک نمایش داده میشود. (مستندات فنی)
- استعلام وضعیت رنگ چک حقوقی — در این سرویس، با وارد کردن شناسه ملی، درخروجی کد رنگ چک نمایش داده میشود. (مستندات فنی)
- اطلاعات ضمانت نامه — با وارد کردن شناسه ضمانتنامه (guaranteeId)، جزئیات ضمانتنامه شامل بدهی، تاریخ صدور و سررسید و نوع ضمانت برگردانده میشود. (مستندات فنی)
- گزارش اعتباری (مرحله ۱) — ثبت درخواست JSON — با کد ملی و شماره موبایل، درخواست گزارش اعتباری با خروجی JSON ثبت میشود. (مستندات فنی)
- گزارش اعتباری (مرحله ۱) — ثبت درخواست PDF — با کد ملی و شماره موبایل، درخواست گزارش اعتباری با خروجی PDF ثبت میشود. (مستندات فنی)
- گزارش اعتباری (مرحله ۲) — دریافت نتیجه — با assessmentId دریافتی از ثبت درخواست JSON یا ثبت درخواست PDF وضعیت پردازش و در صورت آماده بودن، گزارش برگردانده میشود. (مستندات فنی)
- وثایق و تضامین ضمانت نامه — با وارد کردن شناسه ضمانتنامه (guaranteeId)، فهرست وثایق و تضامین متصل به آن ضمانتنامه برگردانده میشود. (مستندات فنی)
- وضعیت رنگ چک پیامکی — در این سرویس، با وارد کردن شناسه ملی حقیقی یا حقوقی، درخروجی کد رنگ چک نمایش داده میشود. (مستندات فنی)