API استعلام شبا
استعلام شبا با API بازارپی: بانک، شماره حساب، وضعیت و صاحبان حساب را از روی شماره شبا بگیرید؛ پرداخت به ازای هر درخواست موفق.
سرویس استعلام شبا اطلاعات یک حساب بانکی را از روی شماره شبای آن برمی‌گرداند: بانک، شماره حساب، وضعیت حساب و صاحبان حساب. این سرویس برای کسب‌وکارهایی که پیش از واریز یا ثبت حساب مقصد باید از درستی شبا و نام صاحب آن مطمئن شوند، یک فراخوانی ساده API است.
درخواست با متد GET به مسیر /ide/v1/ibans و با توکن دسترسی در هدر Authorization ارسال می‌شود. ساختار درخواست و پاسخ مطابق API استاندارد رایج است و جزئیات کامل آن در مرجع API آمده است.
برای استفاده، در بازارپی ثبت‌نام کنید، سرویس را درخواست دهید و پس از تأیید، کلید API بسازید. یک جفت کلید برای همه سرویس‌ها کار میکند، دسترسی هر کلید را می‌توانید به IP سرورهای خود محدود کنید و با «کلید تست» پاسخ نمونه بدون کسر هزینه بگیرید. هزینه به ریال و فقط برای درخواست‌های موفق از کیف پول (پیش‌پرداخت) یا سقف اعتبار (پس‌پرداخت) کسر می‌شود؛ خطاهای سمت ارائهدهنده (۵xx) هرگز محاسبه نمیشوند.
کاربردها
- بررسی شبای مقصد و نام صاحب حساب پیش از تسویه یا واریز وجه
- اعتبارسنجی شبایی که کاربر هنگام ثبت‌نام یا تکمیل پروفایل وارد میکند
- نمایش نام صاحب حساب به کاربر برای تأیید پیش از انتقال
- بررسی وضعیت حساب پیش از ثبت آن به‌عنوان حساب تسویه
سرویس‌ها و قیمت
جزئیات کامل درخواست و پاسخ در مرجع API و نحوه دریافت توکن در راهنمای فنی آمده است.
سؤالات متداول
استعلام شبا چه اطلاعاتی برمی‌گرداند؟
بانک، شماره حساب، وضعیت حساب و صاحبان حساب مرتبط با شماره شبا.
برای بررسی تعلق شبا به یک کد ملی چه سرویسی لازم است؟
سرویس «تطبیق شبا و کد ملی» دقیقاً همین کار را میکند و در صفحه تطبیق کارت، شبا و حساب با کد ملی معرفی شده است.
هزینه این سرویس چطور محاسبه می‌شود؟
قیمت هر سرویس به ریال در همین صفحه و کاتالوگ آمده است. فقط درخواست‌های موفق (و طبق قوانین هر سرویس) محاسبه می‌شوند، خطاهای سمت ارائهدهنده و قطعی ارتباط هرگز هزینه ندارند و مالیات بر ارزش افزوده جداگانه در صورتحساب می‌آید.
میتوانم پیش از استفاده واقعی تست کنم؟
بله. با «کلید تست» در پنل، درخواستها همه بررسیهای عادی را میگذرانند اما به ارائهدهنده ارسال نمیشوند؛ پاسخ نمونه با همان ساختار مرجع API برمیگردد و هزینهای کسر نمیشود.