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