سرویس «تبدیل حساب به شبا» در دسته استعلام و تبدیل بانکی فینوتک با دریافت شماره حساب و کد بانک، شبای متناظر را همراه با نام بانک، وضعیت حساب و صاحبان حساب برمیگرداند. این خروجی به شما اجازه میدهد پروندههایی را که فقط شماره حساب دارند، بدون تماس با مشتری برای انتقال بینبانکی آماده کنید.
تبدیل حساب به شبا چه مشکلی را حل میکند؟
بسیاری از دادههای بانکی که در سامانههای مالی ایرانی انباشته شدهاند، شماره حساب هستند نه شبا؛ قراردادهای قدیمی، فرمهای کاغذی و سیستمهای پیشین با شماره حساب پر شدهاند. برای واریز از مسیر پایا و ساتنا اما شبا لازم است و واحد مالی ناچار میشود تکتک افراد را پیدا کند و از آنها شبا بخواهد؛ فرآیندی که برای فهرستهای بلند عملاً هفتهها طول میکشد و بخشی از پروندهها همیشه ناقص میماند.
این سرویس آن تبدیل را خودکار میکند: شماره حساب و کد بانک را میفرستید و شبای متناظر را میگیرید. مهمتر اینکه وضعیت حساب هم در پاسخ میآید؛ بنابراین حسابهای بسته، راکد یا مسدود و حتی مواردی که اصلاً حسابی متناظر ندارند، پیش از قرار گرفتن در فایل پرداخت شناسایی میشوند و فهرست تسویه شما از ابتدا تمیز ساخته میشود.
کاربردهای تبدیل حساب به شبا
- آمادهسازی فهرست حقوق و دستمزد — سوابق پرسنلی که با شماره حساب ثبت شدهاند، برای پرداخت بینبانکی به شبا تبدیل میشوند.
- مهاجرت داده از سامانههای قدیمی — پایگاه داده مشتریان یا تامینکنندگان بهصورت دستهای با شبا غنیسازی میشود.
- پرداخت مطالبات و اقساط در شرکتهای خدماتی — حساب اعلامشده در قرارداد به شبای قابل پرداخت تبدیل و وضعیت آن کنترل میشود.
- تسویه با تامینکنندگان در زنجیره تامین — پیش از هر دوره پرداخت، حسابهای غیرفعال از فهرست کنار گذاشته میشوند.
- پرداخت وجوه و کمکهای دورهای در نهادهای غیرانتفاعی — فهرست ذینفعان با شماره حساب، به فهرست مقصدهای معتبر تبدیل میشود.
- تکمیل پرونده مشتری در فرمهای ثبتنام — کاربری که فقط شماره حساب میداند، بدون مراجعه به اپلیکیشن بانک ثبتنام را کامل میکند.
مزایای تبدیل حساب به شبا
- تبدیل انبوه سوابق موجود — دادههای قدیمی بدون تماس با مشتری برای پرداخت بینبانکی قابل استفاده میشوند.
- جداسازی حسابهای غیرقابل واریز — وضعیت حساب پیش از ساخت فایل پرداخت مشخص میشود و دستور واریز بینتیجه صادر نمیشود.
- تطبیق هویت در کنار تبدیل — صاحبان حساب در پاسخ میآیند و میتوانید تعلق حساب به طرف قرارداد را بررسی کنید.
- پشتیبانی از قالبهای متفاوت بانکی — شماره حساب بانکهای مختلف با رعایت قاعده جداکننده همان بانک پذیرفته میشود.
- پیگیری هر تبدیل — ارسال
trackIdیکتا، تطبیق نتایج با رکوردهای داخلی شما را ساده میکند.
چه چیزی از تبدیل حساب به شبا دریافت میکنید؟
جزئیات ورودی، خروجی و نمونه پاسخ در مستندات فنی آمده است.
جریان کار تبدیل حساب به شبا
- ۱. گرفتن توکن — با اسکوپ
facility:cc-deposit-iban:getتوکن Client Credential دریافت کنید. - ۲. ارسال حساب و کد بانک — شماره حساب را با قالب درست همان بانک، به همراه کد بانک و یک
trackIdیکتا بفرستید. - ۳. خواندن شبا و وضعیت حساب — شبا، نام بانک، وضعیت حساب و صاحبان حساب را از پاسخ بردارید.
- ۴. اعمال قاعده پرداخت — فقط حسابهایی را وارد فایل پرداخت کنید که وضعیتشان اجازه واریز میدهد و نام صاحب حساب با طرف قرارداد میخواند.
- ۵. ذخیره و ممیزی — شبای بهدستآمده و وضعیت بازگشتی را همراه
trackIdدر سوابق نگه دارید.
نحوه شروع تبدیل حساب به شبا
این سرویس با رویکرد Client Credential (بدون رضایت پیامکی) فراخوانی میشود. اسکوپ مورد نیاز: facility:cc-deposit-iban:get. ابتدا کلاینت بسازید و توکن بگیرید: راهنمای شروع. سپس از مستندات فنی برای پیادهسازی استفاده کنید.
محدودیتها و نکات تبدیل حساب به شبا
- در شماره حساب از
/بهعنوان جداکننده استفاده کنید. - شماره حساب بانک پاسارگاد باید با فرمت اصلی همان بانک ارسال شود.
- برای بانک رسالت جداکننده نقطه (
.) به کار برود. - ارسال کد بانک صاحب حساب اجباری است؛ بدون آن تبدیل انجام نمیشود.
- وضعیت بازگشتی را جدی بگیرید: حساب میتواند بسته، راکد، مسدود با واریز، مسدود بدون واریز یا اصلاً فاقد حساب باشد و برای هر کدام باید رفتار مشخصی در سامانه خود تعریف کنید.
- حسابهای مشترک بیش از یک صاحب دارند؛ منطق تطبیق نام را برای فهرستی از نامها بنویسید و نتیجه را همراه
trackIdذخیره کنید.
سوالات متداول تبدیل حساب به شبا
تبدیل حساب به شبا چیست؟
سرویسی است که با دریافت شماره حساب و کد بانک، شبای متناظر را همراه نام بانک، وضعیت حساب و صاحبان حساب برمیگرداند تا پرداخت بینبانکی روی مقصد معتبر انجام شود.
چرا باید کد بانک را بفرستم؟
شماره حساب در بانکهای مختلف قالب یکسانی ندارد و بدون مشخص بودن بانک صاحب حساب، تبدیل معنا پیدا نمیکند؛ به همین دلیل کد بانک از ورودیهای اجباری است.
شماره حساب را با چه قالبی ارسال کنم؟
بهصورت پیشفرض با جداکننده /؛ برای بانک رسالت با نقطه و برای بانک پاسارگاد با فرمت اصلی همان بانک.
تفاوت این سرویس با تبدیل کارت به شبا چیست؟
ورودی این سرویس شماره حساب و کد بانک است؛ اگر از مشتری فقط شماره کارت دارید، تبدیل کارت به شبا مسیر درست است.
اگر حساب فعال نباشد چه اتفاقی میافتد؟
وضعیت حساب در پاسخ مشخص میشود و میتوانید پیش از صدور دستور پرداخت، آن رکورد را از فهرست تسویه کنار بگذارید یا برای بررسی علامت بزنید.
مستندات فنی این سرویس کجاست؟
صفحه مشخصات API شامل endpoint، پارامترها و نمونه پاسخ است.
چه نوع احراز هویتی لازم است؟
Grant type: client_credentials. جزئیات در راهنمای توکن.
آیا رضایت پیامکی کاربر لازم است؟
خیر. این سرویس با Client Credential و بدون رضایت پیامکی قابل فراخوانی است.
مستندات فنی تبدیل حساب به شبا
مشاهده مستندات فنی «تبدیل حساب به شبا» — endpoint، پارامترها، نمونه درخواست و پاسخ.