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