دسته «سرویسهای بر پایه حساب» فینوتک دو API برای کار روی حساب بانکی تأییدشده دارد: خواندن گردش حساب با رویکرد Client Credential و انتقال وجه داخلی، پایا و ساتنا به حساب یا شبا. مرز این دسته با استعلام و تبدیل بانکی روشن است؛ آنجا شناسه تبدیل و صاحب حساب خوانده میشود و اینجا پول جابهجا میشود یا صورتحساب ساخته میشود.
درباره دسته سرویسهای بر پایه حساب
کار اول، دیدن حرکت حساب است. دریافت گردش حساب با شماره حساب و بازه تاریخ، فهرست تراکنشها، مانده و جزئیات واریز و برداشت را برمیگرداند تا تسویه، مغایرتگیری و نمایش صورتحساب در سامانه شما روی داده ساختیافته سوار شود. این نسخه با توکن Client Credential صدا زده میشود و برای بانک صادرات هدر کلید API جداگانه لازم است.
کار دوم، خود انتقال است. انتقال وجه به حساب از حساب مبدأ تأییدشده اپلیکیشن، به حساب همان بانک یا شبای سایر بانکها واریز میکند؛ نوع انتقال داخلی، پایا یا ساتنا از روی مقصد تشخیص داده میشود. این سرویس پس از رضایت کاربر با رویکرد Authorization Code کار میکند و در بانک کشاورزی مسیر Authorization SMS هم دارد.
این دسته موجودی را بهعنوان محصول جداگانه نمیفروشد و شناسه کارت/شبا را تبدیل نمیکند. پیش از واریز، اگر فقط شبا یا کارت دارید، ابتدا از دسته استعلام و تبدیل بانکی مقصد را بسازید یا صاحب حساب را بررسی کنید.
کاربردهای کسبوکاری سرویسهای بر پایه حساب
- صورتحساب و مغایرتگیری خزانهداری — واحد مالی بازه تراکنشها را با دریافت گردش حساب میخواند و با دفاتر داخلی تطبیق میدهد.
- نمایش گردش در پنل مشتری — کیف پول و باشگاه مشتریان، حرکت حساب متصل را بدون مراجعه به اینترنتبانک به کاربر نشان میدهند.
- تسویه با فروشنده و تامینکننده — بازارگاه و پلتفرم چندفروشندگی با انتقال وجه به حساب مبلغ دوره را به حساب یا شبای مقصد واریز میکنند.
- پرداخت حقوق، جایزه و کارمزد — فهرست مقصدهای حساب/شبا از داخل سامانه حقوق یا باشگاه مشتریان ارسال میشود.
- پیگیری پس از واریز نامشخص — وقتی پاسخ انتقال
PENDING،UNKNOWNیا کد ۴۰۸ است، تکرار کور انجام نمیشود و ابتدا صورتحساب همان حساب با گردش حساب بررسی میشود.
انتخاب سرویس مناسب در سرویسهای بر پایه حساب
- میخواهم ببینم چه تراکنشهایی روی حساب آمده است — دریافت گردش حساب. بازه را حداکثر ۳۱ روز بفرستید.
- میخواهم از حساب تأییدشده به حساب یا شبا واریز کنم — انتقال وجه به حساب. مقصد کارت موضوع صفحه دیگری است؛ این سرویس روی حساب و شبا تمرکز دارد.
- فقط میخواهم بدانم شبا مال کیست، نه اینکه پول بفرستم — به استعلام شبا و صاحبان حساب بروید.
- توکن پیامکی دارم یا Client Credential؟ — گردش حساب این دسته با Client Credential است؛ انتقال وجه با Authorization Code است، بانک صادرات
client_credentialsو بانک کشاورزیauthorization_sms.
شروع کار با سرویسهای بر پایه حساب
ابتدا کلاینت بسازید و اسکوپ همان سرویسی را که لازم دارید فعال کنید؛ مسیر کامل در راهنمای شروع آمده است. حساب مبدأ باید برای اپلیکیشن شما تأیید شده باشد. برای هر فراخوانی یک trackId یکتا بفرستید و آن را کنار نتیجه نگه دارید.
مشخصات فنی هر عملیات، شامل پارامترها، الزام بانکبهبانک و نمونه پاسخ، در صفحه همان سرویس و لینک مستندات فنی آن آمده است.
سوالات متداول سرویسهای بر پایه حساب
این دسته چه کاری انجام میدهد؟
روی حساب بانکی تأییدشده دو کار میکند: خواندن گردش حساب، و انتقال وجه داخلی / پایا / ساتنا به حساب یا شبا.
تفاوت این دسته با استعلام و تبدیل بانکی چیست؟
آنجا شناسه کارت، حساب و شبا خوانده یا تبدیل میشود و پولی جابهجا نمیشود. اینجا صورتحساب ساخته میشود یا وجه از حساب مبدأ خارج میگردد.
چه نوع توکنی لازم است؟
گردش حساب با Client Credential (بانک کشاورزی: Authorization SMS). انتقال وجه با Authorization Code؛ بانک صادرات Client Credential و بانک کشاورزی Authorization SMS. جزئیات در راهنمای شروع.
اگر نتیجه انتقال نامشخص بود چه کنم؟
تراکنش را تکرار نکنید. ابتدا صورتحساب را با دریافت گردش حساب ببینید و برای پایا تا مشخص شدن سیکل صبر کنید.
مشخصات فنی هر سرویس کجاست؟
از فهرست پایین همین صفحه وارد صفحه هر سرویس شوید؛ آنجا لینک مستقیم به مستندات فنی با پارامترها و نمونه درخواست و پاسخ وجود دارد.
فهرست سرویسهای سرویسهای بر پایه حساب
- انتقال وجه به حساب — سرویس انتقال وجه (داخلی، پایا و ساتنا) از حساب کلاینت به حساب دیگران: با این سرویس میتوانید از حساب مبدأ خود در بانک به حساب مقصد همان بانک یا به شماره شبا سایر بانکها پول واریز کنید. (مستندات فنی)
- دریافت گردش حساب — با دریافت یک حساب و تاریخ بهعنوان پارامتر، لیست تراکنشهای بازه زمانی ارسالشده آن حساب را برمیگرداند. (مستندات فنی)