سرویس «گزارش اعتباری (مرحله ۱) — ثبت درخواست JSON» در دسته تسهیلات و اعتبارسنجی فینوتک با دریافت کد ملی و شماره موبایل یک شخص حقیقی، درخواست تهیه گزارش اعتباری او را با خروجی ساختیافته JSON ثبت میکند و شناسهای برای پیگیری همان درخواست برمیگرداند. این مرحله نقطه آغاز پرونده اعتباری متقاضی است و متن گزارش در مرحله دوم، با دریافت نتیجه، خوانده میشود.
گزارش اعتباری (مرحله ۱) — ثبت درخواست JSON چه مشکلی را حل میکند؟
در بسیاری از فرآیندهای وامدهی و فروش اقساطی در ایران، ارزیابی اعتباری متقاضی هنوز با مدارک کاغذی پیش میرود: مشتری برگهای را از شعبه یا دفتر پیشخوان میگیرد، تصویری از آن را میفرستد و کارشناس باید درستی و تازگی آن را حدس بزند. نتیجه این چرخه، پروندههای نیمهکاره، تصمیمهای مبتنی بر مدرک قدیمی و ریزش بخش بزرگی از متقاضیان در فاصله بین ثبتنام و تایید نهایی است.
این سرویس همان درخواست را به یک فراخوانی در دل محصول شما تبدیل میکند. کاربر با تایید پیامکی اجازه دسترسی میدهد، شما کد ملی و شماره موبایل او را ثبت میکنید و بهجای انتظار در همان درخواست، یک شناسه پیگیری میگیرید تا هر زمان که گزارش آماده شد آن را بهصورت داده ساختیافته بردارید. نوع خروجی در همین مرحله قفل میشود و مرحله دریافت نتیجه همان قالب JSON را برمیگرداند.
کاربردهای گزارش اعتباری (مرحله ۱) — ثبت درخواست JSON
- وامدهی خرد دیجیتال — پیش از تخصیص سقف وام، درخواست گزارش اعتباری متقاضی در همان نشست ثبتنام ثبت میشود و پرونده بدون وقفه کاغذی جلو میرود.
- خرید اقساطی و اعتبار در محل فروش — فروشگاههای اینترنتی و پلتفرمهای پرداخت اقساطی، بررسی اعتباری خریدار را همزمان با ثبت سفارش آغاز میکنند.
- لیزینگ خودرو و تجهیزات — شرکت لیزینگ پیش از ارزیابی وثیقه، درخواست گزارش را ثبت میکند تا پرونده متقاضی از ابتدا مستند باشد.
- ضمانت و صدور ضمانتنامه — در بررسی متقاضی ضمانت، این مرحله شروع مستندسازی وضعیت اعتباری شخص حقیقی است.
- بازبینی دورهای سقف اعتبار مشتریان فعال — با گرفتن رضایت دوباره کاربر، درخواست گزارش تازه برای بهروزرسانی سقف یا تمدید قرارداد ثبت میشود.
- پذیرش نمایندگان و فروشندگان دارای مهلت تسویه — پیش از دادن اعتبار تجاری به شخص حقیقی، پرونده اعتباری او آغاز میشود.
مزایای گزارش اعتباری (مرحله ۱) — ثبت درخواست JSON
- ثبت ناهمگام بدون قفلکردن تجربه کاربر — درخواست ثبت میشود و شناسه پیگیری برمیگردد؛ لازم نیست کاربر در صفحه منتظر بماند تا گزارش تهیه شود.
- خروجی ساختیافته برای موتور تصمیم — قالب JSON از ابتدا مشخص میشود تا قواعد تایید و رد روی فیلدهای گزارش اجرا شود.
- کنترل تطبیق موبایل و کد ملی پیش از ثبت — اگر شماره موبایل به همان کد ملی تعلق نداشته باشد، درخواست از ابتدا رد میشود و هزینه پیگیری پرونده اشتباه پرداخت نمیشود.
- حذف انتخاب دستی سطح گزارش — سطح گزارش را کلاینت تعیین نمیکند و بالاترین سطح مجاز برای مشتری بهطور خودکار انتخاب میشود؛ منطق سمت شما سادهتر میماند.
- رضایت کاربر بهشکل قابل ممیزی — دسترسی با تایید پیامکی خود شخص صادر میشود و درخواست به همان تایید گره میخورد.
چه چیزی از گزارش اعتباری (مرحله ۱) — ثبت درخواست JSON دریافت میکنید؟
جزئیات ورودی، خروجی و نمونه پاسخ در مستندات فنی آمده است.
جریان کار گزارش اعتباری (مرحله ۱) — ثبت درخواست JSON
- ۱. درخواست احراز هویت — با اسکوپ
credit:assessment-submit-json:postمرحله درخواست احراز هویت را فراخوانی کنید تا پیامک تایید برای کاربر ارسال شود. - ۲. تایید کد یکبار مصرف — کدی که کاربر دریافت کرده است را در مرحله تایید احراز هویت بفرستید.
- ۳. گرفتن توکن پیامکی — با کد بازگشتی، توکن را در مرحله درخواست توکن بگیرید.
- ۴. ثبت درخواست گزارش JSON — کد ملی و شماره موبایل همان شخص را با توکن پیامکی به مسیر
/assessmentSubmit/jsonارسال کنید و شناسه پیگیری گزارش را بگیرید. - ۵. نگهداری شناسه و ادامه در مرحله دوم — شناسه بازگشتی را در پرونده مشتری ذخیره کنید و نتیجه را با دریافت نتیجه گزارش اعتباری بخوانید.
نحوه شروع گزارش اعتباری (مرحله ۱) — ثبت درخواست JSON
این سرویس با رویکرد Authorization SMS (با تایید پیامکی کاربر) فراخوانی میشود. اسکوپ مورد نیاز: credit:assessment-submit-json:post. ابتدا کلاینت بسازید و توکن بگیرید: راهنمای شروع. سپس از مستندات فنی برای پیادهسازی استفاده کنید.
محدودیتها و نکات گزارش اعتباری (مرحله ۱) — ثبت درخواست JSON
- شماره موبایل باید به همان کد ملی تعلق داشته باشد؛ پیش از ثبت، تطبیق شاهکار انجام میشود و در صورت ناهمخوانی، درخواست با خطا رد میشود.
- ورودیها قالب مشخص دارند: کد ملی شخص حقیقی دهرقمی و شماره موبایل با قالب
09xxxxxxxxx؛ ارقام را پیش از ارسال یکسانسازی کنید. - سطح گزارش (پایه، استاندارد یا پیشرفته) انتخابی نیست؛ بالاترین سطح مجاز برای مشتری اعمال میشود، پس به سطح خاصی در منطق کسبوکار وابسته نشوید.
- پاسخ این مرحله گزارش نیست؛ فقط ثبت موفق درخواست و شناسه پیگیری است. اگر شناسه را ذخیره نکنید، دسترسی به نتیجه از دست میرود.
- نوع خروجی در همین فراخوانی ذخیره میشود و سرویس دریافت نتیجه همان قالب JSON را برمیگرداند.
- برای هر فراخوانی
trackIdیکتا بفرستید تا پیگیری خطاها و تطبیق با گزارشهای داخلی شما ساده باشد. - محتوای گزارش اعتباری داده حساس مشتری است؛ دسترسی به آن و مدت نگهداری آن را از ابتدا محدود کنید.
سوالات متداول گزارش اعتباری (مرحله ۱) — ثبت درخواست JSON
«گزارش اعتباری (مرحله ۱) — ثبت درخواست JSON» چیست؟
سرویسی است که با دریافت کد ملی و شماره موبایل شخص حقیقی، درخواست تهیه گزارش اعتباری با خروجی JSON را ثبت میکند و شناسه پیگیری آن درخواست را برمیگرداند. متن گزارش در این مرحله بازگردانده نمیشود.
تفاوت این مرحله با مرحله دریافت نتیجه چیست؟
این مرحله درخواست را ایجاد میکند و دریافت نتیجه با همان شناسه، وضعیت پردازش و در صورت آماده بودن، گزارش JSON را برمیگرداند. هر دو مرحله لازم است و هر کدام اسکوپ خود را دارد.
اگر شماره موبایل با کد ملی همخوان نباشد چه میشود؟
درخواست ثبت نمیشود. تطبیق شاهکار پیش از ثبت انجام میشود و در صورت ناهمخوانی، پاسخ خطا برمیگردد؛ در رابط کاربری امکان اصلاح شماره را پیشبینی کنید.
آیا میتوانم سطح گزارش را انتخاب کنم؟
خیر. سطح گزارش را کلاینت انتخاب نمیکند و بالاترین سطح مجاز برای مشتری بهکار میرود.
اگر فایل PDF میخواهم از کدام سرویس استفاده کنم؟
برای خروجی فایل از ثبت درخواست PDF استفاده کنید. نوع خروجی در مرحله ثبت انتخاب میشود نه در دریافت نتیجه.
مستندات فنی این سرویس کجاست؟
صفحه مشخصات API شامل endpoint، پارامترها و نمونه پاسخ است.
چه نوع احراز هویتی لازم است؟
Grant type: authorization_sms. جزئیات در راهنمای توکن.
آیا رضایت پیامکی کاربر لازم است؟
بله. این سرویس با رویکرد Authorization SMS و پس از تایید پیامکی کاربر فراخوانی میشود.
مستندات فنی گزارش اعتباری (مرحله ۱) — ثبت درخواست JSON
مشاهده مستندات فنی «گزارش اعتباری (مرحله ۱) — ثبت درخواست JSON» — endpoint، پارامترها، نمونه درخواست و پاسخ.