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