ملی ای‌پی‌آی

اعتبارسنجی ساختار شماره شبا

ساختار شبا رقم کنترلی دارد، پس درستی‌اش بدون هیچ استعلامی قابل بررسی است. ولی این با «حساب وجود دارد» یکی نیست.

شماره شبا طوری طراحی شده که بیشتر غلط‌های تایپی را بتوان بدون پرسیدن از هیچ سامانه‌ای تشخیص داد.

چطور کار می‌کند

شبا IR است به‌علاوه ۲۴ رقم. دو رقم اول این ۲۴ رقم، رقم کنترلی‌اند و از روی بقیه شماره محاسبه می‌شوند.

الگوریتمش استاندارد جهانی است: چهار کاراکتر اول به انتهای شماره منتقل می‌شوند، حروف به عدد تبدیل می‌شوند، و باقی‌مانده کل عدد بر ۹۷ باید دقیقاً ۱ باشد.

API ما همین محاسبه را پیش از تماس با سامانهٔ بانکی انجام می‌دهد.

چه چیزی را می‌گیرد

  • یک رقم اشتباه. هر تک‌رقمِ غلط باقی‌مانده را عوض می‌کند.
  • جابه‌جا شدن دو رقم مجاور. رایج‌ترین غلط تایپ.
  • کم یا زیاد بودن تعداد ارقام.
  • جا افتادن IR.

چه چیزی را نمی‌گیرد

این نکته مهم است: بررسی ساختاری فقط شکل را تأیید می‌کند.

یک شبای ساختاری‌درست می‌تواند:

  • به هیچ حسابی متصل نباشد
  • به حسابی متصل باشد که بسته شده
  • متعلق به کسی باشد که فکر می‌کنید نیست

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

فاصله و ارقام فارسی

فاصله بین ارقام مشکلی ندارد؛ API خودش حذفشان می‌کند. ارقام فارسی هم پذیرفته و تبدیل می‌شوند.

حروف IR هم می‌تواند کوچک تایپ شود.

چرا این بررسی برای شما خوب است

چون رایگان است و پیش از پرداخت انجام می‌شود.

اگر عددی که دارید از نظر ساختاری غلط باشد، همان‌جا پاسخ invalid_input می‌گیرید و بابت استعلامی که از اول شکست می‌خورد، هزینه‌ای کسر نمی‌شود.

بعد از بررسی ساختاری چه؟

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

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

آخرین بازبینی: تیم تحریریه ملی ای‌پی‌آی

وب‌سرویس مرتبط با این راهنما

API استعلام شماره شبا

اعتبار و مشخصات یک شماره شبا را بررسی کنید.

مشاهده مشخصات فنی و تعرفه

راهنماهای مرتبط

پرسش و تجربه کاربران

اگر این راهنما جوابتان را نداد، همین‌جا بپرسید. پرسش‌ها را تیمملی ای‌پی‌آی پاسخ می‌دهد و هر نظر پیش از انتشار بررسی می‌شود.

هنوز پرسشی ثبت نشده، اولین نفر باشید.