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