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