API استعلام شماره شبا
با شماره شبا، نام صاحب حساب و بانک صادرکننده را برمی‌گرداند، برای وقتی که فقط شبا را دارید و باید بدانید به حساب چه کسی می‌ریزید.
این سرویس چه می‌کند
ورودی این استعلام فقط یک شماره شبا است و خروجی، اطلاعات حساب متناظر شامل نام صاحب حساب و بانک.
تفاوتش با تطابق شبا و کد ملی مهم است و اغلب اشتباه گرفته می‌شود: آنجا شما هویت را در دست دارید و می‌خواهید تأییدش کنید؛ اینجا فقط شبا را دارید و می‌خواهید بدانید مال کیست. اگر جریان کاری شما کد ملی کاربر را دارد، تطابق ارزان‌تر و دقیق‌تر به هدف می‌رساند.
کاربرد عملی در تسویه
بیشتر تیم‌ها از این استعلام برای نمایش تأییدیه پیش از واریز استفاده می‌کنند: کاربر شبا را وارد می‌کند و شما نام صاحب حساب را به او نشان می‌دهید تا خودش تأیید کند. این کوچک‌ترین تغییری است که نرخ واریز به حساب اشتباه را پایین می‌آورد، چون خطا را به کسی نشان می‌دهد که می‌تواند تشخیصش دهد.
آنچه این استعلام نمی‌کند
موجودی، وضعیت فعال بودن و سقف تراکنش را نمی‌گوید. شبایی که وجود نداشته باشد، پاسخ «یافت نشد» می‌گیرد که یک نتیجه معتبر و هزینه‌دار است.
کجا به کار می‌آید
- تأییدیه پیش از واریزنام صاحب حساب را به کاربر نشان دهید تا خودش تأیید کند. خطا را به کسی نشان می‌دهید که می‌تواند تشخیصش دهد.
- بررسی شباهای واردشده در فرمشبای اشتباه یا متعلق به بانک دیگر را پیش از ذخیره در پایگاه داده تشخیص دهید.
- تطبیق نام فروشنده با حساب مقصددر مارکت‌پلیس‌ها، نام صاحب حساب باید با نام فروشنده ثبت‌شده بخواند؛ اختلاف، نشانه‌ای است که ارزش بررسی دارد.
ورودی و خروجی
ورودی
ibanstringشباخروجی
bank_namestringآيندهis_transferablebooleannamestringخیریه تو‌انبخشی بچه های آسمان کامرانقیمت و شرط پرداخت
هر فراخوان ۷۰۰ تومان
مبلغ پیش از تماس با سرویس مرجع از موجودی پنل قفل می‌شود و اگر پاسخی نیاید، آزاد می‌شود. ورودی نامعتبر، در دسترس نبودن سرویس مرجع و عبور از سقف نرخ هزینه‌ای ندارند. «رکوردی یافت نشد» یک پاسخ معتبر است و هزینه دارد.
کمترین مبلغ شارژ پنل: ۱٬۰۰۰٬۰۰۰ تومان
خطاهای این سرویس
IBAN_NOT_FOUNDکد شبای ورودی یافت نشدIBAN_NOT_VALIDشماره شبای وارد شده معتبر نیست
⚠️ این‌ها خطاهای خودِ سرویس‌اند. کدهای عمومی، احراز، سقف نرخ و موجودی، در مستندات فهرست شده‌اند.
پرسش‌های متداول
فرقش با تطابق شبا و کد ملی چیست؟
آنجا هویت را دارید و تأییدش میکنید؛ اینجا فقط شبا را دارید و میپرسید مال کیست. اگر کد ملی کاربر را دارید، تطابق مسیر دقیقتری است.
موجودی حساب را برمی‌گرداند؟
نه. موجودی، مسدودی و سقف تراکنش در خروجی نیستند.
اگر شبا وجود نداشته باشد هزینه کسر می‌شود؟
بله. «یافت نشد» یک پاسخ معتبر است. آنچه هزینه ندارد، ورودی نامعتبر و در دسترس نبودن سرویس مرجع است.