API استعلام کارت بانکی
استعلام کارت بانکی با API بازارپی: نام دارنده، بانک، نوع و وضعیت کارت را از روی شماره کارت بگیرید؛ کلید API واحد و صورتحساب شفاف.
سرویس استعلام اطلاعات کارت، نام دارنده، بانک صادرکننده، نوع و وضعیت یک کارت بانکی را از روی شماره آن برمی‌گرداند. این اطلاعات برای نمایش نام گیرنده پیش از کارت‌به‌کارت، بررسی کارتی که کاربر ثبت می‌کند یا جلوگیری از ورود شماره کارت اشتباه به کار می‌آید.
درخواست با متد GET به مسیر /ide/v1/cards ارسال می‌شود و ساختار آن مطابق API استاندارد رایج است.
برای استفاده، در بازارپی ثبت‌نام کنید، سرویس را درخواست دهید و پس از تأیید، کلید API بسازید. یک جفت کلید برای همه سرویس‌ها کار می‌کند، دسترسی هر کلید را می‌توانید به IP سرورهای خود محدود کنید و با «کلید تست» پاسخ نمونه بدون کسر هزینه بگیرید. هزینه به ریال و فقط برای درخواست‌های موفق از کیف پول (پیش‌پرداخت) یا سقف اعتبار (پس‌پرداخت) کسر می‌شود؛ خطاهای سمت ارائهدهنده (۵xx) هرگز محاسبه نمیشوند.
کاربردها
- نمایش نام دارنده کارت مقصد به کاربر پیش از انتقال
- بررسی کارت بانکی ثبت‌شده در پروفایل کاربر
- تشخیص بانک صادرکننده و وضعیت کارت
سرویس‌ها و قیمت
جزئیات کامل درخواست و پاسخ در مرجع API و نحوه دریافت توکن در راهنمای فنی آمده است.
سؤالات متداول
استعلام کارت چه اطلاعاتی می‌دهد؟
نام دارنده، بانک، نوع و وضعیت کارت بانکی.
برای اطمینان از اینکه کارت متعلق به کد ملی کاربر است چه کنم؟
از سرویس «تطبیق کارت و کد ملی» استفاده کنید که تعلق کارت بانکی به کد ملی را بررسی می‌کند.
هزینه این سرویس چطور محاسبه می‌شود؟
قیمت هر سرویس به ریال در همین صفحه و کاتالوگ آمده است. فقط درخواست‌های موفق (و طبق قوانین هر سرویس) محاسبه می‌شوند، خطاهای سمت ارائهدهنده و قطعی ارتباط هرگز هزینه ندارند و مالیات بر ارزش افزوده جداگانه در صورتحساب می‌آید.
میتوانم پیش از استفاده واقعی تست کنم؟
بله. با «کلید تست» در پنل، درخواستها همه بررسیهای عادی را میگذرانند اما به ارائهدهنده ارسال نمیشوند؛ پاسخ نمونه با همان ساختار مرجع API برمیگردد و هزینهای کسر نمیشود.