سرویس های بر پایه حساب

انتقال وجه به حساب

<!--seo-open-->

از حساب مبدأ تأییدشده به حساب همان بانک یا شبا سایر بانک‌ها واریز داخلی، پایا یا ساتنا انجام می‌شود. سرویس بر پایه حساب فینوتک با رویکرد Authorization Code.

<!--/seo-open-->

سرویس انتقال وجه (داخلی، پایا و ساتنا) از حساب کلاینت به حساب دیگران: با این سرویس می‌توانید از حساب مبدأ خود در بانک به حساب مقصد همان بانک یا به شماره شبا سایر بانک‌ها پول واریز کنید.

Scope: oak:transfer-to:execute<br />

Grant type: authorization_code

بانک صادرات: client_credentials

بانک کشاورزی: authorization_sms

دانلود مستندات ریسپانس کدها

Notes

<div class="docs-notice" dir="rtl"> <p>● این سرویس فقط از مبدأ حساب‌هایی که برای اپلیکیشن شما تأیید شده امکان‌پذیر است.</p> <p>● سیکل‌های پایا تا اطلاع ثانوی:</p> <p class="docs-notice-sub">– چرخه اول: ۱۸:۴۵ روز قبل تا ۰۳:۴۵ روز جاری (بانک پارسیان این سیکل را پشتیبانی نمی‌کند)</p> <p class="docs-notice-sub">– چرخه دو: ۰۳:۴۵ تا ۰۹:۴۵ روز جاری</p> <p class="docs-notice-sub">– چرخه سه: ۰۹:۴۵ تا ۱۲:۴۵ روز جاری</p> <p class="docs-notice-sub">– چرخه چهار: ۱۲:۴۵ تا ۱۸:۴۵ روز جاری</p> <p>● انتقال وجه داخلی به حساب / کارت آینده دقایقی بین ۲۳:۵۴ تا ۰۰:۰۰ که روز مالی بانک بسته می‌شود غیرفعال است.</p> <p>● اگر وضعیت تراکنش داخلی <code>PENDING</code> یا <code>UNKNOWN</code> بود، قبل از تلاش مجدد از آخرین وضعیت مطمئن شوید.</p> <p>● اگر وضعیت تراکنش بین‌بانکی (پایا) <code>PENDING</code> یا <code>UNKNOWN</code> بود، قبل از تلاش مجدد گزارش پایا را ببینید؛ تراکنش با یک سیکل تأخیر در آن فهرست برمی‌گردد.</p> <p>● چند کاراکتر خط‌تیره پیوسته در شرح تراکنش خطای ورودی برمی‌گرداند.</p> <p>● در واریز پایای بانک پارسیان مبلغ همان لحظه از حساب کم نمی‌شود؛ موجودی را با احتساب تراکنش‌های در جریان ببینید.</p> <p>● اگر وضعیت تراکنش ناموفق / نامشخص / تایم‌اوت (کد ۴۰۸) بود از تکرار خودداری کنید و صورتحساب را چک کنید. برای پایا، گزارش پایا را هم ببینید و بعد از حداکثر ۷۲ ساعت تصمیم بگیرید.</p> <p>● دو <code>trackId</code> یکسان سمت فینوتک نفرستید.</p> <p>● بابت (<code>reasonDescription</code>): <a href="/oak-reason-description.html">اطلاعات بیشتر</a></p> <p>● برای بانک صادرات هدر <code>X-API-KEY</code> اجباری است و مقدار آن را فینوتک در اختیار کلاینت می‌گذارد.</p> <p>الزام فیلدهای بدنه بانک‌به‌بانک است. جدول کامل در توضیح هر فیلد آمده است. حداقل مبلغ پایا ۱۰۰۰۰ ریال است.</p> </div>
post/oak/v2/clients/{clientId}/transferTo

Request

  • Base URL: https://api.finnotech.ir
  • URL: https://api.finnotech.ir/oak/v2/clients/{clientId}/transferTo
  • Auth: HTTP bearer

Path parameters

clientIdstring required

Query parameters

trackIdstring required

Correlation ID (max 40 alphanumeric characters). UUID recommended.

Headers

X-API-KEYstring

برای بانک صادرات اجباری است. این مقدار را فینوتک در اختیار کلاینت می‌گذارد.

Request body

amountnumber required

مبلغ انتقال وجه. اجباری برای کشاورزی، آینده، پارسیان و پاسارگاد.

descriptionstring required

شرح انتقال وجه (حداکثر ۳۰ کاراکتر). اجباری برای کشاورزی، آینده، پارسیان و پاسارگاد. چند کاراکتر - پیوسته مجاز نیست.

destinationFirstnamestring

نام صاحب حساب مقصد (حداقل ۲ و حداکثر ۳۰ کاراکتر) برای انتقال پایا و ساتنا. اجباری برای کشاورزی، آینده، پارسیان و پاسارگاد.

destinationLastnamestring

نام خانوادگی صاحب حساب مقصد (حداقل ۲ و حداکثر ۳۰ کاراکتر) برای انتقال پایا و ساتنا. اجباری برای کشاورزی، آینده، پارسیان و پاسارگاد.

destinationNumberstring required

شماره حساب مقصد یا شماره شبا (۲۶ کاراکتر). اگر شماره حساب بانک کاراکتر اضافه مانند خط تیره دارد، همان فرمت را بفرستید. اجباری برای کشاورزی، آینده، پارسیان و پاسارگاد.

paymentNumberstring

شناسه پرداخت؛ در صورتحساب شما و مشتری درج می‌شود (مثلاً شماره فاکتور). حداکثر ۳۰ رقم. اجباری برای بانک آینده.

reasonDescriptionstring

بابت. اجباری برای بانک آینده. فهرست مقادیر در شرح بابت‌ها.

depositstring

شماره حساب مبدأ. اگر توکن انتقال چند حساب مبدأ دارد از این فیلد استفاده کنید؛ وگرنه حساب مبدأ از توکن خوانده می‌شود. اجباری برای بانک کشاورزی.

sourceFirstNamestring

نام صاحب حساب مبدأ برای انتقال پایا و ساتنا. اجباری برای بانک کشاورزی.

sourceLastNamestring

نام خانوادگی صاحب حساب مبدأ برای انتقال پایا و ساتنا. اجباری برای بانک کشاورزی.

secondPasswordstring

رمز انتقال وجه. اجباری برای بانک پارسیان.

merchantNamestring

نام پذیرنده (بانک آینده). اختیاری.

merchantIbanstring

شماره شبا پذیرنده (بانک آینده). اختیاری.

Example request

{
  "amount": 1
}

Response

Successful response

trackIdstring

کد پیگیری که در فراخوانی سرویس فرستاده شده است

statusstring

وضعیت فراخوانی سرویس (DONE یا FAILED)

Changes

No recorded changes to this operation across all 1 revision of this API.