API تطابق کد ملی و شماره حساب
بررسی میکند یک شماره حساب بانکی به همان کد ملی تعلق دارد یا نه، با پاسخ بله یا خیر.
این سرویس چه میکند
تطابق کد ملی و شماره حساب چهار ورودی میگیرد، کد ملی، تاریخ تولد، بانک و شماره حساب، و یک پاسخ بله یا خیر برمیگرداند. نام جایی در این جریان نیست، نه در ورودی و نه در خروجی.
برای کسبوکارها همین نبودِ نام، مزیت اصلی است. تطابق بر پایه کد ملی انجام میشود و نه بر پایه رشتهای که املای متفاوت دارد، پس آن دسته از پاسخهای منفیِ ناشی از نگارش نام که در تطابق نامی دردسر میسازند، اینجا اصلاً پیش نمیآیند.
آنچه این استعلام نمیکند
نام و شبا را برنمیگرداند و موجودی را هم نشان نمیدهد. خروجی تنها یک مقدار منطقی است.
تفکیک علت پاسخ منفی هم ندارد: حسابی که به نام فرد دیگری است و حسابی که اصلاً وجود ندارد، هر دو منفی میگیرند.
نکته پیادهسازی
🔴 تاریخ تولد اجباری است و این همان چیزی است که اغلب در طراحی فرم جا میافتد. اگر محصول شما امروز تاریخ تولد نمیگیرد، این استعلام را نمیتوانید فراخوانی کنید، و این را باید پیش از وعدهدادن به تیم محصول بدانید نه بعدش.
تاریخ تولد را به همان قالبی بفرستید که در مستندات آمده و تبدیل تقویم را در لایه خودتان انجام دهید. فرستادن تاریخ شمسی بهجای میلادی، پاسخ منفی میدهد بدون آنکه خطایی ببینید.
کجا به کار میآید
- افتتاح حساب در سرویس مالیحسابی که کاربر برای برداشت اعلام میکند باید به نام خودش باشد. تطابق با کد ملی، از تطابق نامی دقیقتر است.
- احراز برای پرداخت یارانهای و تسهیلاتدر جریانهایی که ذینفع باید قطعی باشد، کد ملی مرجع است و نه نام.
- جلوگیری از حساب واسطحسابی که به نام کاربر نیست، در همین گام رد میشود و از چرخه پولشویی بیرون میماند.
ورودی و خروجی
ورودی
nationalCodestringکد ملیده رقم، با رقم کنترل معتبر.birthDatestringتاریخ تولدتاریخ شمسی (نه میلادی): سال چهاررقمی، ماه و روز دورقمی. 1370/01/05، 1370-01-05 و 13700105 هر سه پذیرفته میشوند.bankstringبانکشناسهٔ لاتین بانک از جدول «کد بانکها»، مثل mellat. کد سهرقمی بانک در شبا (مثل 012) هم پذیرفته میشود.جدول کد بانکها در مستنداتbankAccountstringشمارهٔ حسابشماره حساب دقیقاً با همان قالبی که بانک داده؛ اگر خط تیره، اسلش یا نقطه دارد، همانطور بفرستید.قیمت و شرط پرداخت
هر فراخوان ۳٬۱۰۰ تومان
مبلغ پیش از تماس با سرویس مرجع از موجودی پنل قفل میشود و اگر پاسخی نیاید، آزاد میشود. ورودی نامعتبر، در دسترس نبودن سرویس مرجع و عبور از سقف نرخ هزینهای ندارند. «رکوردی یافت نشد» یک پاسخ معتبر است و هزینه دارد.
کمترین مبلغ شارژ پنل: ۱٬۰۰۰٬۰۰۰ تومان
- ثبتنام در احرازینو و ساخت حساب کسبوکار رایگان است و همهٔ مبلغ شارژ صرف استعلامهای خودتان میشود.
- استعلام زیادی دارید؟ برای تخفیف و تعرفهٔ اختصاصی با پشتیبانی در تماس باشید.
- میخواهید پیش از شارژ آزمایش کنید؟ درخواست شارژ آزمایشی ثبت کنید تا برایتان اضافه کنیم.
پرسشهای متداول
چرا تاریخ تولد لازم است؟
ورودی اجباری این سرویس است. اگر فرم شما تاریخ تولد نمیگیرد، باید پیش از پیادهسازی اضافهاش کنید.
چه فرقی با تطابق شماره حساب و نام دارد؟
آن یکی نام را مقایسه میکند و این یکی کد ملی را. تطابق با کد ملی به املای نام حساس نیست.
علت پاسخ منفی را میگوید؟
نه. حساب متعلق به فرد دیگر و حساب ناموجود، هر دو پاسخ منفی میگیرند.
