دسته «استعلام و تبدیل بانکی» فینوتک ۸ سرویس برای خواندن و تبدیل شناسههای بانکی دارد: شماره شبا، شماره کارت و شماره حساب. با این سرویسها پیش از هر واریز میتوانید بدانید مقصد وجود دارد، در چه وضعیتی است و به نام چه کسی ثبت شده. همین کنترل کوچک پیش از پرداخت، بخش بزرگی از واریزهای ناموفق و پیگیریهای بعدی را حذف میکند.
درباره دسته استعلام و تبدیل بانکی
این دسته دو کار متفاوت انجام میدهد. کار اول تبدیل است: یک شناسه بانکی گرفته میشود و شناسه همارز آن برمیگردد — شماره کارت به شماره حساب، شماره کارت به شبا، و شماره حساب بههمراه کد بانک به شبا. کار دوم استعلام است: با شبا، با شماره کارت عضو شتاب یا با شماره حساب، نام بانک، وضعیت حساب و صاحبان آن خوانده میشود. جدا از این دو، دو سرویس دیگر در همین دسته نام و مشخصات اظهارشده کاربر را با کد ملی و تاریخ تولد او میسنجند و بهجای پاسخ دوحالتی، میزان شباهت نام، نام خانوادگی، نام پدر و جنسیت را گزارش میکنند.
مرز این دسته روشن است: اینجا فقط خوانده و تبدیل میشود. هیچ انتقال وجهی انجام نمیگیرد، موجودی و گردش حساب برنمیگردد و صورتحسابی ساخته نمیشود. بررسی سابقه اعتباری و چک، موضوع دسته تسهیلات و اعتبارسنجی است و احراز عمیق هویت فرد — مانند انطباق تصویری مدارک یا گره زدن شبا به کد ملی — در دسته احراز هویت و شناخت مشتری قرار دارد. یک نکته عملی هم هست که در طراحی جریان باید ببینید: قالب شماره حساب میان بانکها یکسان نیست و در تبدیل حساب به شبا باید مطابق قاعده همان بانک ارسال شود.
کاربردهای کسبوکاری استعلام و تبدیل بانکی
- بازارگاه و تسویه با فروشنده — پیش از نخستین واریز، شبای اعلامشده فروشنده با استعلام شبا و صاحبان حساب بررسی میشود تا نام و وضعیت حساب مقصد پیش از پرداخت روشن باشد.
- پرداخت حقوق و تسویه انبوه — فهرست مقصدها پیش از ارسال دستهای با تبدیل حساب به شبا یکدست میشود و حسابهای بسته یا راکد زودتر کنار گذاشته میشوند.
- کیف پول و برداشت کاربر — کاربر شماره کارت خود را وارد میکند و مقصد برداشت با تبدیل کارت به شبا ساخته میشود، بدون اینکه لازم باشد کاربر شبا را دستی بنویسد.
- فرمهای ثبت حساب در پنل مالی — استعلام کارت نام دارنده کارت و بانک صادرکننده را نشان میدهد تا کاربر همانجا اشتباه خود را ببیند.
- ثبتنام و پذیرش مشتری — احراز هویت با کد ملی نام واردشده در فرم را با صاحب واقعی کد ملی میسنجد و میزان شباهت را برمیگرداند.
- بازپرداخت و عودت وجه — برای برگرداندن مبلغ به مشتری، تبدیل شماره کارت به شماره حساب مقصد را از روی کارت او میسازد.
- سرویسهای متصل به بانک خاورمیانه — استعلام حساب برای شماره حسابهای این بانک، نام بانک و نام صاحب حساب را برمیگرداند.
انتخاب سرویس مناسب در استعلام و تبدیل بانکی
- چه چیزی در دست دارم و چه چیزی میخواهم؟ — از کارت به حساب با تبدیل شماره کارت به شماره حساب، از کارت به شبا با تبدیل کارت به شبا، و از شماره حساب و کد بانک به شبا با تبدیل حساب به شبا. هر سه علاوه بر شناسه مقصد، اطلاعات تکمیلی حساب را هم میدهند.
- فقط شبا دارم و میخواهم بدانم مال کیست — استعلام شبا و صاحبان حساب نام بانک، شماره حساب، وضعیت و صاحبان حساب را برمیگرداند و برای بررسی مقصد پیش از پرداخت نقطه شروع مناسبی است.
- فقط نام دارنده کارت برایم مهم است — استعلام کارت برای کارتهای عضو شتاب همین را میدهد؛ اگر در ادامه به شبا یا شماره حساب هم نیاز دارید، مستقیم سراغ سرویسهای تبدیل کارت بروید تا یک فراخوانی کم شود.
- سرویس تبدیل خودش نام صاحب حساب را میدهد، پس چرا سرویس احراز جداست؟ — نامی که سرویسهای تبدیل و استعلام برمیگردانند، نام ثبتشده روی حساب است و به کد ملی گره نمیخورد. اگر میخواهید بدانید دادهای که کاربر وارد کرده با هویت واقعی او میخواند یا نه، احراز هویت با کد ملی میزان شباهت را عددی گزارش میکند و آستانه پذیرش را خودتان تعیین میکنید.
- باید رضایت کاربر ثبت شود — احراز هویت با کد ملی با پیامک همان سنجش را انجام میدهد، با این تفاوت که فراخوانی پس از تایید پیامکی کاربر ممکن است.
- شماره حساب بانک خاورمیانه دارم — استعلام حساب برای همین منظور ساخته شده و نام صاحب حساب را برمیگرداند؛ برای سایر بانکها مسیر درست، تبدیل حساب به شبا است.
شروع کار با استعلام و تبدیل بانکی
پیش از فراخوانی، یک کلاینت بسازید و توکن بگیرید؛ مسیر کامل در راهنمای شروع آمده است. برای هر فراخوانی هم یک شناسه پیگیری یکتا بفرستید تا بعدا بتوانید پاسخها را با تراکنشهای خودتان تطبیق دهید.
سرویسهای تبدیل و استعلام این دسته با رویکرد Client Credential فراخوانی میشوند و به تایید مشتری نیاز ندارند؛ تبدیل شماره کارت به شماره حساب حتی بدون افزودن حساب به کلاینت هم کار میکند. تنها نسخه پیامکی احراز هویت با کد ملی است که توکن Authorization SMS میخواهد. مشخصات فنی هر سرویس، شامل پارامترها و کدهای وضعیت حساب، در صفحه مستندات فنی همان سرویس آمده است.
سوالات متداول استعلام و تبدیل بانکی
تفاوت سرویس تبدیل و سرویس استعلام چیست؟
سرویس تبدیل یک شناسه را به شناسه دیگری نگاشت میکند، مثلا کارت به شبا. سرویس استعلام شناسه را ورودی میگیرد و اطلاعات پیرامون آن، مثل بانک و وضعیت و صاحبان حساب، را برمیگرداند. در عمل بسیاری از جریانها به هر دو نیاز دارند.
چه نوع توکنی لازم است؟
همه سرویسها جز نسخه پیامکی احراز هویت با کد ملی، با توکن Client Credential فراخوانی میشوند. جزئیات گرفتن توکن در راهنمای شروع است.
آیا رضایت صاحب حساب لازم است؟
برای سرویسهای تبدیل و استعلام خیر. اگر فرآیند شما باید نشان دهد استعلام با اطلاع خود شخص انجام شده، از نسخه پیامکی احراز هویت با کد ملی با پیامک استفاده کنید.
وضعیت حساب در خروجی یعنی چه؟
سرویسهای شبا و تبدیل، علاوه بر شناسه مقصد، وضعیت حساب را هم برمیگردانند؛ حساب میتواند فعال، بسته، راکد یا مسدود با یا بدون قابلیت واریز باشد. معنای هر کد در مستندات فنی همان سرویس فهرست شده است.
نتیجه استعلام تا کی معتبر است؟
پاسخ، تصویر همان لحظه از وضعیت حساب است. برای پرداختهای دورهای یا مقصدهایی که مدتهاست ذخیره شدهاند، بازبینی دورهای را در فرآیند خود پیشبینی کنید.
فهرست سرویسهای استعلام و تبدیل بانکی
- احراز هویت با کد ملی — احراز هویت با کد ملی؛ این سرویس کد ملی، تاریخ تولد و نام را دریافت میکند و شباهت نام ارسالشده را با نام واقعی صاحب کد ملی برمیگرداند. (مستندات فنی)
- احراز هویت با کد ملی با پیامک — احراز هویت با کد ملی؛ این سرویس کد ملی، تاریخ تولد و نام را دریافت میکند و شباهت نام ارسالشده را با نام واقعی صاحب کد ملی برمیگرداند. (مستندات فنی)
- استعلام حساب — برای استعلام شماره حسابهای بانک خاورمیانه از این سرویس استفاده میشود. (مستندات فنی)
- استعلام شبا و صاحبان حساب — سرویس استعلام اطلاعات شبا — با وارد کردن شماره شبا، اطلاعات حساب، بانک و صاحبان حساب برگردانده میشود. (مستندات فنی)
- استعلام کارت — برای استعلام شماره کارتهای عضو شتاب از این سرویس استفاده کنید. (مستندات فنی)
- تبدیل حساب به شبا — این سرویس با وارد کردن شماره حساب و کد بانک، شماره شبا را نمایش میدهد. (مستندات فنی)
- تبدیل شماره کارت به شماره حساب — این سرویس با وارد کردن شماره کارت، شماره حساب را نمایش میدهد. (مستندات فنی)
- تبدیل کارت به شبا — این سرویس با دریافت شماره کارت، اطلاعات شماره شبا را نمایش میدهد. (مستندات فنی)