سرویس «انتقال وجه به حساب» در دسته سرویسهای بر پایه حساب فینوتک از حساب مبدأ تأییدشده اپلیکیشن، وجه را به حساب همان بانک یا شماره شبا سایر بانکها واریز میکند. نوع انتقال — داخلی، پایا یا ساتنا — از روی مقصد مشخص میشود و در پاسخ، کد پیگیری و وضعیت تراکنش برمیگردد.
انتقال وجه به حساب چه مشکلی را حل میکند؟
تسویه با فروشنده، پرداخت حقوق و واریز کارمزد وقتی به اینترنتبانک دستی وابسته است، هم کند است و هم تکرار واریز در وضعیت نامشخص را زیاد میکند. یک رقم اشتباه در مقصد یا تکرار تراکنش پس از تایماوت، پول را دو بار از حساب خارج میکند یا در سیکل پایا معلق میگذارد.
این سرویس همان دستور پرداخت را به یک فراخوانی API تبدیل میکند: مبلغ، شرح، مقصد (حساب یا شبا) و در صورت نیاز نام صاحب حساب مقصد را میفرستید. پاسخ شامل کد پیگیری بانک، نوع انتقال و فیلدهایی برای رفع مغایرت است. اگر وضعیت PENDING، UNKNOWN یا کد ۴۰۸ بود، بهجای تکرار فوری، ابتدا صورتحساب را بررسی میکنید.
کاربردهای انتقال وجه به حساب
- تسویه دورهای با فروشنده — بازارگاه مبلغ دوره را به حساب یا شبای فروشنده واریز میکند.
- پرداخت حقوق و پورسانت — فهرست مقصدهای حساب از سامانه حقوق به همین API وصل میشود.
- عودت وجه به مشتری — مبلغ به حساب اعلامشده مشتری در همان بانک یا شبا برمیگردد.
- پرداخت به تامینکننده بینبانکی — وقتی مقصد در بانک دیگری است، انتقال پایا یا ساتنا از روی شبا انجام میشود.
- خزانهداری سازمانی — دستور پرداخت از داخل پنل مالی صادر میشود و حساب مبدأ همان حساب تأییدشده اپلیکیشن است.
مزایای انتقال وجه به حساب
- یک endpoint برای داخلی و بینبانکی — مقصد حساب یا شبا است و نوع انتقال در پاسخ مشخص میشود.
- حساب مبدأ از پیش تأییدشده — واریز فقط از حسابهایی که برای اپلیکیشن شما فعال شدهاند انجام میشود.
- کد پیگیری برای مغایرت —
refCodeو در پایا/ساتناpayaSatnaInquiryTrackIdبرای پیگیری بعدی ذخیره میشود. - سقف مبلغ روی توکن — اگر مبلغ از محدودیت تعریفشده هنگام گرفتن توکن بالاتر باشد، درخواست رد میشود.
- شناسه یکتا برای هر دستور —
trackIdاجباری است و نباید تکرار شود.
چه چیزی از انتقال وجه به حساب دریافت میکنید؟
جزئیات ورودی، خروجی و نمونه پاسخ در مستندات فنی آمده است.
جریان کار انتقال وجه به حساب
- ۱. گرفتن دسترسی از صاحب حساب مبدأ — با رویکرد Authorization Code و اسکوپ
oak:transfer-to:executeرضایت را بگیرید. برای بانک کشاورزی مسیر Authorization SMS هم وجود دارد. - ۲. ارسال دستور پرداخت — مبلغ، شرح، مقصد و فیلدهای الزامی همان بانک را همراه یک
trackIdیکتا بفرستید. - ۳. خواندن نوع و کد پیگیری —
type،refCodeو در صورت پایا/ساتناpayaSatnaInquiryTrackIdرا ذخیره کنید. - ۴. برخورد با وضعیت نامشخص — در
PENDING،UNKNOWNیا کد ۴۰۸ تراکنش را تکرار نکنید؛ صورتحساب را با دریافت گردش حساب ببینید. - ۵. تصمیم پس از سیکل پایا — برای بینبانکی تا مشخص شدن سیکل صبر کنید و حداکثر پس از ۷۲ ساعت درباره تکرار تصمیم بگیرید.
نحوه شروع انتقال وجه به حساب
این سرویس با رویکرد Authorization Code (پس از رضایت کاربر) فراخوانی میشود. بانک کشاورزی Authorization SMS هم میپذیرد. اسکوپ مورد نیاز: oak:transfer-to:execute. ابتدا کلاینت بسازید و توکن بگیرید: راهنمای شروع. سپس از مستندات فنی برای پیادهسازی استفاده کنید.
محدودیتها و نکات انتقال وجه به حساب
- فقط از حساب مبدأ تأییدشده برای اپلیکیشن شما قابل فراخوانی است.
- فیلدهای اجباری بین بانک کشاورزی، آینده، پارسیان و پاسارگاد فرق دارد؛ جدول در مستندات فنی آمده است.
- بابت (
reasonDescription) برای بانک آینده اجباری است؛ فهرست در شرح بابتها. - چند کاراکتر
-پیوسته در شرح تراکنش خطا میدهد. - حداقل مبلغ پایا ۱۰۰۰۰ ریال است.
- دو
trackIdیکسان نفرستید. - انتقال داخلی آینده حوالی ۲۳:۵۴ تا ۰۰:۰۰ که روز مالی بسته است غیرفعال است.
- در پایای پارسیان مبلغ همان لحظه از حساب کم نمیشود.
سوالات متداول انتقال وجه به حساب
انتقال وجه به حساب چیست؟
سرویسی است که از حساب مبدأ تأییدشده به حساب همان بانک یا شبا سایر بانکها واریز میکند و نوع انتقال (داخلی یا پایا) را در پاسخ برمیگرداند.
آیا میتوان به کارت هم واریز کرد؟
این صفحه روی مقصد حساب و شبا تمرکز دارد. جزئیات فیلدها و الزام بانکها در مستندات فنی آمده است.
اگر پاسخ ۴۰۸ یا وضعیت نامشخص بود چه کنم؟
تراکنش را تکرار نکنید. صورتحساب را با دریافت گردش حساب چک کنید و برای پایا تا مشخص شدن سیکل صبر کنید.
مستندات فنی این سرویس کجاست؟
صفحه مشخصات API شامل endpoint، پارامترها، جدول فیلدهای بانکها و نمونه پاسخ است.
چه نوع احراز هویتی لازم است؟
Grant type: authorization_code. برای بانک کشاورزی authorization_sms هم هست. جزئیات در راهنمای توکن.
آیا رضایت کاربر لازم است؟
بله. انتقال وجه پس از رضایت صاحب حساب مبدأ با Authorization Code (یا پیامک در کشاورزی) انجام میشود.
مستندات فنی انتقال وجه به حساب
مشاهده مستندات فنی «انتقال وجه به حساب» — endpoint، پارامترها، نمونه درخواست و پاسخ.