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