API تبدیل کارت به شبا
شماره شبای متصل به یک کارت بانکی را برمیگرداند، برای وقتی که کاربر فقط شماره کارتش را می‌داند ولی شما برای واریز به شبا نیاز دارید.
این سرویس چه میکند
ورودی یک شماره کارت شانزده‌رقمی است و خروجی، شبای همان حساب به‌همراه نام بانک.
این شکاف رایج‌ترین نقطه اصطکاک در فرم‌های تسویه است: کاربر شماره کارتش را از بر است، ولی شبایش را نه. اگر از او شبا بخواهید، باید برود اپلیکیشن بانکش را باز کند، و بخشی از کاربران همان‌جا فرم را رها می‌کنند. با این استعلام، شماره کارت می‌گیرید و شبا را خودتان درمی‌آورید.
نکته پیاده‌سازی
شماره کارت را پیش از فراخوان از فاصله و خط تیره پاک کنید. کاربران معمولاً کارت را به شکل چهار گروه چهارتایی وارد می‌کنند و این طبیعی است؛ پاک‌کردن جداکنندهها کار سمت شماست.
آنچه این استعلام نمی‌کند
مالکیت را نمی‌سنجد. اینکه شبای متصل به کارت را می‌گیرید، به این معنا نیست که آن حساب به نام کاربر شماست. اگر مالکیت برایتان مهم است، و در تسویه معمولاً هست، تطابق کارت و کد ملی سرویس جداگانهای است.
کجا به کار می‌آید
- فرم تسویه با شماره کارتبه‌جای درخواست شبا، شماره کارت بگیرید و شبا را خودتان درآورید. کاربری که مجبور نشود اپلیکیشن بانکش را باز کند، فرم را رها نمی‌کند.
- مهاجرت داده‌های قدیمیاگر پایگاه داده‌تان فقط شماره کارت دارد و حالا برای تسویه شبا لازم است، یک بار تبدیل دسته‌ای انجام دهید.
- بازگشت وجه به همان کارتبرای برگرداندن پول به حسابی که پرداخت از آن انجام شده، شبای متناظر همان کارت لازم است.
ورودی و خروجی
ورودی
cardNumberstringشمارهٔ کارتخروجی
IBANstringIRXXXXXXXXXXXbank_namestringآیندهnamestringنام صاحب کارتقیمت و شرط پرداخت
هر فراخوان ۱٬۰۰۰ تومان
مبلغ پیش از تماس با سرویس مرجع از موجودی پنل قفل می‌شود و اگر پاسخی نیاید، آزاد می‌شود. ورودی نامعتبر، در دسترس نبودن سرویس مرجع و عبور از سقف نرخ هزینهای ندارند. «رکوردی یافت نشد» یک پاسخ معتبر است و هزینه دارد.
کمترین مبلغ شارژ پنل: ۱٬۰۰۰٬۰۰۰ تومان
پرسش‌های متداول
مالکیت کارت را هم تأیید میکند؟
نه. فقط شبای متناظر را برمیگرداند. برای سنجش مالکیت، تطابق کارت و کد ملی سرویس جداگانهای است.
شماره کارت را با فاصله بفرستم مشکلی ندارد؟
پیش از فراخوان جداکنندهها را پاک کنید. ورودی نامعتبر هزینهای ندارد ولی کاربر شما یک بار بیدلیل خطا میبیند.
برای همه بانکها کار میکند؟
برای کارتهای شبکه بانکی کشور بله. کارتی که در شبکه پیدا نشود، پاسخ «یافت نشد» میگیرد.