API و وب سرویس تطابق کد ملی و شماره حساب

بررسی می‌شود شمارهٔ حساب در بانکی مشخص با کد ملی و تاریخ تولد واردشده به یک شخص تعلق دارد یا نه.

این سرویس چه می‌کند

گاهی مشتری قدیمی فقط شمارهٔ حساب دفترچه‌اش را دارد و شبا را بلد نیست. این استعلام برای همین حالت است: بانک را از فهرست انتخاب می‌کنید، شمارهٔ حساب را می‌دهید، همراه کد ملی و تاریخ تولد شمسی، و در matched می‌گیرید که حساب مال همین شخص است یا نه.

ورودی چهار مقدار دارد: کد ملی، تاریخ تولد، بانک و شمارهٔ حساب. شمارهٔ حساب بدون بانک معنا ندارد، چون هر بانک الگوی خودش را دارد و یک عدد در دو بانک می‌تواند دو حساب متفاوت باشد.

بانک و شمارهٔ حساب را چطور بفرستیم

بانک را از همان فهرست انتخابی فرم بردارید، نه از متن آزاد. شمارهٔ حساب می‌تواند رقم، خط تیره، نقطه یا اسلش داشته باشد و باقی نویسه‌ها پاک می‌شود، ولی دست‌کم چهار رقم لازم است. اگر شمارهٔ حساب قدیمی با صفرهای ابتدایی است، آنها را نیفتادن‌شان را بررسی کنید؛ صفر حذف‌شده یک تطبیق منفی می‌سازد.

علت‌های رایج منفی برای حساب درست

انتخاب بانک اشتباه رایج‌ترین دلیل منفی است، مخصوصاً برای بانک‌هایی که ادغام شده‌اند. حساب مشترک و حساب شرکتی هم برای صاحب واقعی منفی می‌دهند. پیش از رد کردن کاربر، بانک و شمارهٔ حساب را دوباره با او مرور کنید.

با نتیجه چه کنیم

اگر پرداخت شما به شبا کار می‌کند، بهتر است همین‌جا تطبیق را با شمارهٔ حساب بگیرید و بعد شبا را جدا بسازید. پاسخ مثبت را با شناسهٔ پاسخ بایگانی کنید. کش چند روزه است و source.cached می‌گوید پاسخ تازه است یا نه.

آنچه این سرویس نمی‌کند

شمارهٔ شبا، نام صاحب حساب، موجودی و وضعیت حساب را برنمی‌گرداند. همچنین همهٔ بانک‌ها را پوشش نمی‌دهد؛ آنچه در فهرست فرم هست قابل استفاده است. برای کارت یا شبا سرویس‌های جداگانه وجود دارد.

کجا به کار می‌آید

  • اعتبارسنجی حساب مشتریان قدیمی صرافیصرافی‌ای که پروندهٔ کاغذی مشتریان را دیجیتال می‌کند، شمارهٔ حساب و بانک ثبت‌شده را با کد ملی هر پرونده می‌سنجد.
  • پرداخت خسارت در بیمهشرکت بیمه پیش از واریز خسارت، حسابی را که زیان‌دیده اعلام کرده با کد ملی او تطبیق می‌دهد.
  • ثبت حساب مقصد در سامانهٔ خیریهمؤسسه‌ای که کمک‌های ماهانه به خانوارهای نیازمند می‌پردازد، شمارهٔ حساب دریافت‌کننده را با کد ملی سرپرست خانوار می‌سنجد.

ورودی و خروجی

ورودی

nationalCodestringکد ملیده رقم، با رقم کنترل معتبر.
birthDatestringتاریخ تولدتاریخ شمسی (نه میلادی): سال چهاررقمی، ماه و روز دورقمی. 1370/01/05، 1370-01-05 و 13700105 هر سه پذیرفته می‌شوند.
bankstringبانکشناسهٔ لاتین بانک از جدول «کد بانک‌ها»، مثل mellat. کد سه‌رقمی بانک در شبا (مثل 012) هم پذیرفته می‌شود.جدول کد بانک‌ها در مستندات
bankAccountstringشمارهٔ حسابشماره حساب دقیقاً با همان قالبی که بانک داده؛ اگر خط تیره، اسلش یا نقطه دارد، همان‌طور بفرستید.

قیمت و شرط پرداخت

قیمت هر فراخوان API تطابق کد ملی و شماره حساب ۳٬۲۰۰ تومان است.

قیمت هر استعلام API تطابق کد ملی و شماره حساب بر اساس تعداد استعلام در ماه
تعداد استعلام در ماهقیمت هر استعلام
همهٔ فراخوان‌ها۳٬۲۰۰ تومان

آخرین تغییر قیمت:

مبلغ پیش از تماس با سرویس مرجع از موجودی پنل قفل می‌شود و اگر پاسخی نیاید، آزاد می‌شود. ورودی نامعتبر، در دسترس نبودن سرویس مرجع و عبور از سقف نرخ هزینه‌ای ندارند. «رکوردی یافت نشد» یک پاسخ معتبر است و هزینه دارد.

کمترین مبلغ شارژ پنل: ۵۰۰٬۰۰۰ تومان

پرسش‌های متداول

چرا باید بانک را هم انتخاب کنم؟

شمارهٔ حساب فقط درون یک بانک معنا دارد و الگوی هر بانک فرق می‌کند. بدون بانک، یک عدد ممکن است به دو حساب متفاوت برسد. بانک را از فهرست فرم انتخاب کنید.

تفاوتش با تطبیق شبا و کد ملی چیست؟

ورودی شبا یک شناسه است و بانک را در خودش دارد. اینجا بانک و شمارهٔ حساب جدا گرفته می‌شود. اگر شبا دارید، سرویس شبا ساده‌تر و کم‌خطاتر است.

شمارهٔ حساب را با چه قالبی بفرستم؟

رقم، خط تیره، نقطه و اسلش پذیرفته می‌شود و سایر نویسه‌ها پاک می‌شوند. دست‌کم چهار رقم لازم است. صفرهای ابتدایی را نیندازید.

چرا برای حساب درست جواب منفی می‌گیرم؟

بانک ممکن است اشتباه انتخاب شده باشد، حساب به نام شخص دیگر یا شرکت باشد، یا تاریخ تولد با کد ملی نخواند. هر سه را با کاربر مرور کنید.

آیا همهٔ بانک‌ها پشتیبانی می‌شوند؟

نه لزوماً. فقط بانک‌های موجود در فهرست فرم قابل استفاده‌اند. برای بانکی که در فهرست نیست، می‌توانید شبا بگیرید و سرویس تطبیق شبا را به کار ببرید.

آیا نام صاحب حساب برگردانده می‌شود؟

نه. فقط matched برمی‌گردد. اگر نام لازم دارید، سرویس تطبیق حساب با نام را به کار ببرید.

آیا تاریخ تولد اجباری است؟

بله. چهار ورودی کد ملی، تاریخ تولد، بانک و شمارهٔ حساب همگی لازم‌اند. ورودی ناقص یا نامعتبر با invalid_input رد می‌شود و هزینه ندارد.

اگر حساب مشترک باشد چه می‌شود؟

برای هر یک از دارندگان نتیجه به رکورد بانک بستگی دارد و تضمینی نیست. مسیر دستی برای حساب‌های مشترک در نظر بگیرید.