تبدیل شماره کارت به شماره حساب

کاربرد کسب‌وکاری (نسخه Client Credential بدون رضایت پیامکی): این سرویس با وارد کردن شماره کارت، شماره حساب را نمایش می‌دهد.

مستندات فنی

سرویس «تبدیل شماره کارت به شماره حساب» در دسته استعلام و تبدیل بانکی فینوتک با گرفتن یک شماره کارت، شماره حساب متناظر و نام صاحب حساب را برمی‌گرداند. این خروجی زمانی به کار می‌آید که مشتری فقط کارت خود را در اختیار دارد اما فرآیند شما به شماره حساب نیاز دارد.

تبدیل شماره کارت به شماره حساب چه مشکلی را حل می‌کند؟

بیشتر کاربران شماره کارت خود را از بر هستند، چون روی کارت نوشته شده و هر روز از آن استفاده می‌کنند؛ اما شماره حساب چیزی است که باید در اپلیکیشن بانک دنبالش بگردند یا از برگه افتتاح حساب پیدا کنند. وقتی فرم شما شماره حساب می‌خواهد، بخشی از کاربران همان‌جا فرآیند را رها می‌کنند و بخشی دیگر عددی ناقص یا متعلق به حساب دیگری وارد می‌کنند که خطای آن فقط در زمان پرداخت آشکار می‌شود.

این سرویس آن گام اضافه را حذف می‌کند: کاربر همان شماره کارتی را که به خاطر دارد وارد می‌کند و سامانه شما شماره حساب متناظر را از سرویس می‌گیرد. نام صاحب حساب هم در پاسخ می‌آید تا بتوانید پیش از ثبت اطلاعات، تعلق حساب به همان مشتری را کنترل کنید و ثبت‌نام را بدون رفت‌وبرگشت به پایان برسانید.

کاربردهای تبدیل شماره کارت به شماره حساب

  • تکمیل خودکار فرم اطلاعات بانکی — کاربر کارت را وارد می‌کند و شماره حساب بدون تایپ دستی در فرم پر می‌شود.
  • پذیرش فروشنده در پلتفرم‌های چندفروشندگی — هنگام ثبت‌نام فروشنده، اطلاعات حساب برای تسویه‌های بعدی از روی شماره کارت تکمیل می‌شود.
  • سامانه‌های حقوق و دستمزد و پرداخت پیمانکاران — واحد مالی به‌جای جمع‌آوری برگه حساب از افراد، شماره حساب را از روی کارت آن‌ها استخراج می‌کند.
  • پرونده‌های بیمه و پرداخت خسارت — شماره حساب ذی‌نفع بدون مراجعه حضوری و بدون پیوست مدرک بانکی تکمیل می‌شود.
  • پاک‌سازی و تکمیل پایگاه داده مشتریان — رکوردهایی که فقط شماره کارت دارند، پیش از دوره پرداخت بعدی با شماره حساب کامل می‌شوند.

مزایای تبدیل شماره کارت به شماره حساب

  • کاهش رهاشدگی فرم‌ها — از کاربر اطلاعاتی خواسته نمی‌شود که در لحظه در دسترسش نیست.
  • کنترل هویت همراه با تبدیل — نام صاحب حساب در همان پاسخ می‌آید و لازم نیست برای تطبیق نام، فراخوانی جداگانه‌ای انجام دهید.
  • بدون نیاز به افزودن حساب — سرویس را با توکن بدون حساب فراخوانی می‌کنید و نیازی به ثبت قبلی حساب نیست.
  • داده آماده برای فرآیندهای مالی — شماره حساب بازگشتی مستقیم به جریان‌های ثبت ذی‌نفع و تسویه شما وصل می‌شود.
  • ثبت زمان انجام — زمان انجام استعلام در پاسخ می‌آید و برای مستندسازی سوابق مالی قابل استفاده است.

چه چیزی از تبدیل شماره کارت به شماره حساب دریافت می‌کنید؟

جزئیات ورودی، خروجی و نمونه پاسخ در مستندات فنی آمده است.

جریان کار تبدیل شماره کارت به شماره حساب

  • ۱. دریافت توکن — با اسکوپ facility:card-to-deposit:get توکن Client Credential بگیرید.
  • ۲. ارسال شماره کارت — کارت را به همراه یک trackId یکتا برای سرویس ارسال کنید.
  • ۳. برداشت شماره حساب و نام — شماره حساب متناظر و نام صاحب حساب را از پاسخ بخوانید.
  • ۴. تصمیم‌گیری در فرآیند — نام بازگشتی را با اطلاعات مشتری بسنجید و حساب را ثبت یا پرونده را برای بررسی دستی علامت‌گذاری کنید.
  • ۵. نگهداری سابقه — شماره حساب به‌دست‌آمده، زمان انجام و trackId را در سوابق مشتری ذخیره کنید.

نحوه شروع تبدیل شماره کارت به شماره حساب

این سرویس با رویکرد Client Credential (بدون رضایت پیامکی) فراخوانی می‌شود. اسکوپ مورد نیاز: facility:card-to-deposit:get. ابتدا کلاینت بسازید و توکن بگیرید: راهنمای شروع. سپس از مستندات فنی برای پیاده‌سازی استفاده کنید.

محدودیت‌ها و نکات تبدیل شماره کارت به شماره حساب

  • برای فراخوانی این سرویس نیازی به افزودن حساب نیست؛ توکن بدون حساب کافی است.
  • شماره کارت را بدون فاصله، خط تیره یا کاراکتر جداکننده ارسال کنید.
  • خروجی این سرویس شماره حساب است، نه شبا؛ برای واریزهای پایا و ساتنا به شبا نیاز دارید.
  • شماره حساب در بانک‌های مختلف قالب یکسانی ندارد؛ در ذخیره‌سازی آن را به‌صورت رشته نگه دارید و صفرهای ابتدایی را حذف نکنید.
  • نتیجه، وضعیت همان لحظه است؛ اگر کارت مشتری تعویض شود یا حساب تغییر کند، استعلام را دوباره انجام دهید.
  • برای هر فراخوانی یک trackId یکتا بفرستید تا پیگیری خطاها و تطبیق سوابق ساده باشد.

سوالات متداول تبدیل شماره کارت به شماره حساب

تبدیل شماره کارت به شماره حساب چیست؟

سرویسی است که با دریافت شماره کارت، شماره حساب متناظر و نام صاحب حساب را برمی‌گرداند تا فرم‌ها و فرآیندهای مالی بدون درخواست شماره حساب از کاربر تکمیل شوند.

تفاوت این سرویس با تبدیل کارت به شبا چیست؟

خروجی این سرویس شماره حساب داخلی بانک است؛ اگر برای انتقال بین‌بانکی به شبا نیاز دارید، تبدیل کارت به شبا گزینه درست است و وضعیت حساب را هم برمی‌گرداند.

آیا نام صاحب حساب هم برگردانده می‌شود؟

بله. نام صاحب حساب در پاسخ می‌آید و می‌توانید آن را با نام ثبت‌شده مشتری در سامانه خود تطبیق دهید.

برای فراخوانی باید حساب را از قبل اضافه کنم؟

خیر. این سرویس با توکن بدون حساب قابل فراخوانی است و افزودن حساب پیش‌نیاز آن نیست.

مستندات فنی این سرویس کجاست؟

صفحه مشخصات API شامل endpoint، پارامترها و نمونه پاسخ است.

چه نوع احراز هویتی لازم است؟

Grant type: client_credentials. جزئیات در راهنمای توکن.

آیا رضایت پیامکی کاربر لازم است؟

خیر. این سرویس با Client Credential و بدون رضایت پیامکی قابل فراخوانی است.

مستندات فنی تبدیل شماره کارت به شماره حساب

مشاهده مستندات فنی «تبدیل شماره کارت به شماره حساب» — endpoint، پارامترها، نمونه درخواست و پاسخ.

سرویس‌های مرتبط با تبدیل شماره کارت به شماره حساب