API و وب سرویس تطابق شماره حساب و نام
بانک، شماره حساب و نام را می‌گیرد و می‌گوید آن حساب به نام همان فرد ثبت شده است یا نه، برای مواقعی که طرف مقابل شبا ندارد.
این سرویس چه میکند
پیمانکاری فاکتور داده و در پایین برگه نوشته: «بانک ملت، حساب ۱۲۳۴-۵۶-۷۸۹». شبا و کارتی در کار نیست. حسابداری باید پول را بفرستد و کسی نیست که بگوید این شماره واقعاً مال همین پیمانکار است. تطابق شماره حساب و نام برای همین موقعیت ساخته شده است: بانک، شماره حساب و نام را می‌دهید و جواب میگیرید که به هم می‌خورند یا نه.
سه ورودی لازم است، چون یک شماره حساب بدون بانک معنایی ندارد. در پاسخ، data یک مقدار منطقی به نام matched دارد و نام صاحب حساب برنمی‌گردد.
شماره حساب را همانطور که بانک داده است بفرستید
خط تیره و اسلش داخل شمارهٔ حساب برداشته نمیشود، چون قالب حساب در بعضی بانکها همین جداکننده‌ها را دارد و حذفشان شمارهٔ دیگری می‌سازد. فقط نویسههای غیرمجاز مثل حروف و فاصله پاک میشود و دست‌کم چهار رقم باید بماند، وگرنه invalid_input میگیرید. پس شماره را از روی فاکتور کپی کنید، نه از روی نسخهٔ تمیزشدهٔ خودتان.
بانک را از فهرست بسته انتخاب کنید
فیلد bank یک شناسهٔ لاتین از فهرست بانک‌هاست، مثل mellat، و نام تایپ‌شدهٔ کاربر نیست. فهرست مجاز در صفحهٔ مستندات هر سرویس آمده است. بانک اشتباه بدترین حالت را می‌سازد: ورودی از اعتبارسنجی می‌گذرد، استعلام واقعاً انجام میشود و جواب منفی میگیرید بدون اینکه نام ایرادی داشته باشد.
وقتی شبا هم دارید
اگر شبا در دست است، تطابق شبا و نام سادهتر است و بانک نمی‌خواهد. این سرویس برای حساب‌هایی است که فقط شماره حساب دارند: قراردادهای قدیمی، دفترچه‌های چک و فرم‌هایی که کسی شبا ننوشته است.
آنچه این سرویس نمیکند
نام صاحب حساب و شبا را نمی‌دهد و وضعیت حساب را هم نمی‌گوید. پاسخ منفی سه علت می‌تواند داشته باشد، نام ناهماهنگ، بانک اشتباه یا شمارهٔ ناقص، و سرویس این‌ها را از هم جدا نمیکند. قبل از اعلام «حساب مال او نیست»، اول بانک و شماره را با برگهٔ اصلی بسنجید.
کجا به کار میآید
- پرداخت فاکتور به پیمانکار با شماره حسابحسابداری پیش از ثبت دستور پرداخت، بانک و شمارهٔ حسابِ ته فاکتور را با نام پیمانکار می‌سنجد و شمارهٔ دست‌نویس اشتباه را قبل از واریز می‌گیرد.
- ثبت حساب پزشک یا درمانگاه در بیمهبرای پرداخت مطالبات مراکز درمانی که فقط شمارهٔ حساب اعلام می‌کنند، تعلق حساب به نام مرکز پیش از اولین پرداخت تأیید میشود.
- بازپرداخت ودیعه در پلتفرم اجارهمستأجر یا مالک در فرم فقط شمارهٔ حساب نوشته؛ پیش از برگشت ودیعه، تعلق حساب به نامی که در قرارداد آمده بررسی میشود.
ورودی و خروجی
ورودی
bankstringبانکشناسهٔ لاتین بانک از جدول «کد بانکها»، مثل mellat. کد سه‌رقمی بانک در شبا (مثل 012) هم پذیرفته میشود.جدول کد بانکها در مستنداتbankAccountstringشمارهٔ حسابشماره حساب دقیقاً با همان قالبی که بانک داده؛ اگر خط تیره، اسلش یا نقطه دارد، همانطور بفرستید.namestringنامنام و نام خانوادگی به فارسی، دست‌کم سه حرف.قیمت و شرط پرداخت
قیمت هر فراخوان API تطابق شماره حساب و نام ۸۰۰ تومان است.
| تعداد استعلام در ماه | قیمت هر استعلام |
|---|---|
| همهٔ فراخوان‌ها | ۸۰۰ تومان |
آخرین تغییر قیمت:
مبلغ پیش از تماس با سرویس مرجع از موجودی پنل قفل میشود و اگر پاسخی نیاید، آزاد میشود. ورودی نامعتبر، در دسترس نبودن سرویس مرجع و عبور از سقف نرخ هزینهای ندارند. «رکوردی یافت نشد» یک پاسخ معتبر است و هزینه دارد.
کمترین مبلغ شارژ پنل: ۵۰۰٬۰۰۰ تومان
پرسش‌های متداول
برای تطابق شماره حساب با نام چرا بانک را هم باید انتخاب کنم؟
چون شماره حساب بدون بانک به یک حساب مشخص اشاره نمیکند و قالب آن در بانکها یکسان نیست. بانک را از فهرست مجاز انتخاب کنید و نام تایپشده را نفرستید.
شماره حساب را با خط تیره بفرستم یا بدون آن؟
همانطور که بانک داده است. خط تیره و اسلش برداشته نمیشود و حذف دستیشان ممکن است شمارهای بسازد که بانک نمیشناسد. فقط نویسههای غیرمجاز مثل حروف پاک میشود.
اگر فقط شمارهٔ حساب دارم و شبا ندارم، چطور مالکیتش را بسنجم؟
بانک، شمارهٔ حساب و نام را همینجا بفرستید. اگر شبای آن حساب را بهدست آوردید، تطابق شبا و نام سادهتر است. این فراخوان خودش شبا برنمیگرداند.
چرا نام درست در پاسخ، غیرمنطبق میآید؟
سه علت رایج دارد: املای نام در بانک فرق میکند، بانک را اشتباه انتخاب کردهاید، یا شماره حساب ناقص است. پیش از قضاوت، این سه را با برگهٔ اصلی مقایسه کنید.
اطلاعات هویتی صاحب حساب هم دیده میشود؟
نه. پاسخ فقط یک مقدار منطقی است. نام، کد ملی و شبای صاحب حساب برنمی‌گردد و موجودی یا وضعیت حساب هم گزارش نمیشود.
اگر پاسخ منفی بود هزینه دارد؟
بله. استعلام انجامشده و پاسخ منفی هم پاسخ معتبر است و صورتحساب میشود. ورودی نامعتبر، خطای قابلعودت و سقف نرخ رایگاناند. مبلغ کسرشده در billing پاسخ آمده است.
برای حساب شرکتی نام را چطور بفرستم؟
نام ثبتشدهٔ حساب را بفرستید. اگر حساب به نام شرکت است، نام مدیرعامل جواب منفی میدهد. فرم خودتان باید بپرسد حساب حقیقی است یا حقوقی و نام درست را بگیرد.
سقف نرخ چقدر است و اگر رد شود چه میشود؟
پیشفرض شصت فراخوان در دقیقه برای هر سرویس است. فراتر از آن پاسخ ۴۲۹ با هدر Retry-After میگیرید و هزینهای کسر نمیشود. دوباره فراخوانی را پس از مدت اعلامشده بفرستید.