API و وب سرویس تبدیل کارت به حساب
شمارهٔ حساب، نام بانک و نام صاحب کارت را از روی شمارهٔ کارت برمی‌گرداند، برای فرم‌ها و فایل‌هایی که هنوز شمارهٔ حساب میخواهند.
این سرویس چه میکند
این وب سرویس یک شمارهٔ کارت میگیرد و سه مقدار برمی‌گرداند: شمارهٔ حساب در bank_account، نام بانک در bank_name و نام صاحب کارت در name. یعنی سه فیلدی که بسیاری از فرم‌های قدیمی جدا جدا میخواهند، از یک ورودی پر میشود.
سؤال درست پیش از استفاده این است: واقعاً شمارهٔ حساب لازم دارید یا شبا کافی است؟ برای واریز پایا و ساتنا شبا بهتر است و سرویس تبدیل کارت به شبا همان را میدهد. شمارهٔ حساب وقتی لازم میشود که مقصد شما فرم، قرارداد یا سامانه‌ای باشد که قالبش را از قبل با «شمارهٔ حساب، بانک، نام» تعریف کرده.
چه وقت شمارهٔ حساب لازم است و شبا کافی نیست
قراردادهای کاغذی، فرم‌های ثبت‌نام در صندوق‌ها و بعضی سامانه‌های داخلی سازمان‌ها هنوز ستون شمارهٔ حساب دارند. در این موارد کاربر شمارهٔ کارتش را از بر است و شمارهٔ حسابش را نه. تبدیل کارت به حساب او را از باز کردن اپلیکیشن بانک بی‌نیاز میکند.
شمارهٔ حساب را رشته نگه دارید
bank_account را به‌صورت رشته ذخیره کنید، نه عدد. شمارهٔ حساب ممکن است با صفر شروع شود و تبدیل به عدد، صفر ابتدایی را حذف میکند و حساب دیگری می‌سازد. همین نکته برای جداکننده‌های احتمالی هم صدق میکند؛ مقدار را دست‌کاری نکنید.
وضعیت‌هایی که حساب نمی‌دهند
کارت پیدا نشد، منقضی است، مفقودی ثبت شده، غیرفعال است یا حسابش غیرفعال است. هر شش حالت در درگاه ما به not_found با HTTP ۲۰۰ تبدیل میشود و هزینه دارد. پیام سرویس مرجع نوع حالت را میگوید و بهتر است همان معنا به کاربر برسد.
نام را برای تأیید نشان بدهید
name نام ثبت‌شدهٔ صاحب کارت است. نمایش آن کنار فیلد، به کاربر فرصت میدهد اگر کارت دیگری را وارد کرده، همان‌جا اصلاح کند. نام را با نام حساب کاربری خودتان مقایسه کنید، ولی پیش از مقایسه یای و کاف عربی و نیم‌فاصله را یکدست کنید.
آنچه این سرویس نمی‌کند
شبا نمی‌دهد؛ برای آن سرویس تبدیل کارت به شبا هست. موجودی و گردش حساب را نشان نمی‌دهد و نوع کارت را تضمین نمی‌کند: کارت هدیه یا اعتباری ممکن است پاسخ معتبر بدهد ولی برای واریز شما مناسب نباشد. مالکیت را هم با کد ملی نمی‌سنجد.
کجا به کار میآید
- ثبت‌نام عضو در صندوق قرض‌الحسنهمسئول صندوق شمارهٔ کارت عضو را وارد میکند و شمارهٔ حساب، بانک و نام برای پوشهٔ عضویت و فایل واریز وام خودکار پر میشود.
- تنظیم قرارداد با فروشندگان کوچکواحد حقوقی برای قرارداد همکاری که ستون شمارهٔ حساب دارد، از فروشنده فقط کارت میگیرد و بند مالی قرارداد را بدون پرسش دوباره تکمیل میکند.
- رسیدگی به استرداد در خدمات پشتیبانیکارشناس مالی یک شرکت اشتراکی برای مشتری که کارتش را داده، حساب مقصد استرداد را در فرم داخلی ثبت و نام را قبل از دستور واریز تطبیق میدهد.
ورودی و خروجی
ورودی
cardNumberstringشمارهٔ کارتشانزده رقم، بی فاصله یا با فاصله.خروجی
bank_accountstringشماره حسابbank_namestringنام بانکnamestringنام صاحب کارت قیمت و شرط پرداخت
قیمت هر فراخوان API تبدیل کارت به حساب ۸۰۰ تومان است.
| تعداد استعلام در ماه | قیمت هر استعلام |
|---|---|
| همهٔ فراخوان‌ها | ۸۰۰ تومان |
آخرین تغییر قیمت:
مبلغ پیش از تماس با سرویس مرجع از موجودی پنل قفل میشود و اگر پاسخی نیاید، آزاد میشود. ورودی نامعتبر، در دسترس نبودن سرویس مرجع و عبور از سقف نرخ هزینه‌ای ندارند. «رکوردی یافت نشد» یک پاسخ معتبر است و هزینه دارد.
کمترین مبلغ شارژ پنل: ۵۰۰٬۰۰۰ تومان
پرسش‌های متداول
تبدیل شماره کارت به شماره حساب چطور انجام میشود؟
شمارهٔ کارت را در cardNumber میفرستید و شمارهٔ حساب، نام بانک و نام صاحب کارت برمیگردد. ورودی دیگری لازم نیست.
از روی شماره کارت میشود شماره حساب را فهمید؟
با این سرویس بله، اگر کارت و حساب در سرویس مرجع فعال باشند. در غیر این صورت پاسخ not_found می‌گیرید و پیام آن علت را میگوید.
فرق شماره حساب و شبا چیست و کدام را بگیرم؟
شبا قالب استاندارد ۲۶ نویسهای با IR است و شمارهٔ حساب قالبی است که هر بانک خودش تعریف میکند. برای واریز پایا شبا بگیرید؛ برای فرمهایی که شمارهٔ حساب میخواهند، همین سرویس.
اگر کارت منقضی یا مفقود باشد چه پاسخی می‌گیرم؟
پاسخ not_found با HTTP ۲۰۰ و ok:false. کارت پیدا نشد، منقضی، مفقودی، غیرفعال و حساب غیرفعال هر کدام پیام جدای خود را دارند و همه هزینه دارند.
اگر شماره کارت را اشتباه وارد کنم هزینه کسر میشود؟
خیر. کارتی که شانزده رقم نباشد یا از الگوریتم لان نگذرد پیش از تماس با سرویس مرجع invalid_input با HTTP ۴۰۰ میگیرد، بدون کسر هزینه.
شماره حساب برگشتی را عدد ذخیره کنم یا رشته؟
رشته. شمارهٔ حساب ممکن است با صفر شروع شود و تبدیل به عدد آن را تغییر میدهد.
آیا این سرویس نوع کارت را هم مشخص میکند؟
خیر. کارت هدیه، اعتباری یا بنکارت ممکن است پاسخ معتبر بدهد و برای واریز شما مناسب نباشد. اگر این برایتان مهم است، قاعدهاش را در جریان کاری خودتان بگذارید.
حد نرخ وب سرویس تبدیل کارت به حساب چقدر است؟
پیشفرض ۶۰ فراخوان در دقیقه برای هر سرویس است. عبور از آن پاسخ ۴۲۹ با هدر Retry-After میگیرد و هزینه ندارد. برای حجم بیشتر باید سقف حساب شما بالا برده شود.
اگر همان کارت را دوباره بفرستم پاسخ از کش میآید؟
ممکن است. فیلد source.cached میگوید پاسخ از کش بوده یا نه و fetchedAt زمان آن را نشان میدهد. مبلغ کسرشده در billing.amountRial هر پاسخ نوشته شده است.