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