###POST /oak/v2/clients/{clientId}/transferTo
* **شرح: ** سرویس انتقال وجه (داخلی، پایا و ساتنا) از حساب کلاینت به حساب دیگران: با استفاده از این سرویس میتوانید از حساب مبدا خود در بانک به حساب مقصد موجود در همان بانک یا به شماره شبا سایر بانکها پول واریز کنید.
* **اسکوپ: ** ```oak:transfer-to:execute```
* **رویکرد: ** ```Authorization_Code```
* **رویکرد بانک کشاورزی: ** ```Authorization_SMS```
* ** دانلود مستندات ریسپانس کد ها **
````````````````
{address}/oak/v2/clients/{clientId}/transferTo?trackId={trackId}
````````````````
https://sandboxapi.finnotech.ir :address
https://apibeta.finnotech.ir :address
**سرویسهای مرتبط: [گزارش پایا](/doc/oak-payas.html?sandbox=+sandbox/)**
**سرویسهای مرتبط: [پیگیری تراکنش جامع](/doc/oak-proxyInquiry.html?sandbox=+sandbox/)**
**سرویسهای مرتبط: [پیگیری تراکنش داخلی](/doc/oak-transferInquiry.html?sandbox=+sandbox/)**
**سرویسهای مرتبط: [گزارش ساتنا](/doc/oak-satna-inquiry.html?sandbox=+sandbox/)**
**سرویسهای مرتبط : [پیگیری تراکنش](/doc/oak-transactionInquiry-get.html?sandbox=+sandbox/)**
**لطفا جهت انجام سرویس [پیگیری تراکنش جامع](/doc/oak-proxyInquiry.html?sandbox=+sandbox/)، 30 دقیقه بعد از اعلام نتیجه ی سرویس انتقال وجه اقدام نمایید**
** لطفا در صورتیکه نتیجه ی تراکنش انتقال وجه با استاتوس 408 اعلام شد، لطفا از تکرار تراکنش خودداری نموده و سپس از [سرویس پیگیری تراکنش](/doc/oak-transactionInquiry-get.html?sandbox=+sandbox/) استفاده نمایید و پس از مشخص شدن نتیجه ی تراکنش در خروجی سرویس مذکور ، از سرویسهای گزارش گیری استفاده نمایید**
#### Notes
* این سرویس از مبدا حساب هایی که برای اپلیکیشن شما تایید شده است امکان پذیر است.
* سیکل های پایا تا اطلاع ثانوی :
* چرخه اول. 18.45 روز قبل تا 03.45 روز جاری (بانک پارسیان این سیکل را پشتیبانی نمیکند)
* چرخه دو. 03.45 روز جاری تا 10.45 روز جاری
* چرخه سه. 10.45 روز جاری تا 13.45 روز جاری
* چرخه چهار. 13.45 روز جاری تا 18.45 روز جاری
* انتقال وجه داخلی به حساب / کارت آینده دقایقی بین ساعت 23:54 الی 00:00 که روز مالی بانک بسته می شود، غیرفعال است.
* اگر فیلد وضعیت در پاسخ تراکنش داخلی «PENDING» یا «UNKNOWN» بود قبل از تلاش مجدد با فراخوانی سرویس استعلام [Transfer Inquiry service](/oak-transferInquiry.html)از آخرین وضعیت تراکنش اطمینان حاصل نمایید.
* اگر فیلد وضعیت در پاسخ تراکنش بین بانکی(پایا) «PENDING» یا «UNKNOWN» بود قبل از تلاش مجدد با فراخوانی سرویس گزارش پایا [Payas service](/oak-payas.html) از آخرین وضعیت تراکنش اطمینان حاصل نمایید، توجه داشته باشید که تراکنش با یک سیکل تاخیر در این لیست برگردانده خواهد شد.
* درصورت فرستادن چند کاراکتر (-) به هم پیوسته در شرح تراکنش خطا ورودی برگردانده میشود.
* در هنگام واریز پایا در بانک پارسیان مبلغ تراکنش همان لحظه از حساب کم نمیشود لذا همواره به موجودی حساب با احتساب تراکنش ها و مبالغ آن توجه شود
* در صورتیکه وضعیت یک تراکنش ناموفق/ نامشخص/ تایماوت(با استتوس کد 408) بود از تکرار تراکنش خودداری و حتما صورتحساب خود را چک فرمایید. در صورت پایا بودن تراکنشها، گزارش پایای خود را نیز چک بفرمایید و بعد از نهایتا 72 ساعت نسبت به تکرار/ عدم تکرار تراکنشهای فوق تصمیمگیری فرمایید.
* دو trackId یکسان سمت فینوتک ارسال نفرمایید.
#### Headers
مقادیر زیر باید در هدر قرار بگیرد
````````````````
Content-Type: application/json
Authorization : Bearer {Token}
````````````````
#### URI Parameters
* **clientId:** (اجباری) شناسه کلاینت
#### Query Parameters
* **trackId:** (اجباری) رشته ای با طول حداکثر ۴۰ کاراکتر شامل حرف و عدد. در صورت نیاز به نتیجه یک فراخوانی میتوانید با trackId آن را فیلتر کنید. در گزارش فراخوانی سرویس فراخوانی مورد نظر را با همین کد پیگیری پیدا میکنید.
* example: ```transfer-to-deposit-0323```
#### Body
##### Example:
````````````````
{
"amount": 1 ,
"description": "شرح تراکنش" ,
"destinationFirstname": "خلیلی حسینی بیابانی" ,
"destinationLastname": "سمیه غز اله فریماه" ,
"destinationNumber": "IR120620000000302876732005" ,
"paymentNumber": "123456" ,
"deposit": "776700000",
"sourceFirstName": "مارتین" ,
"sourceLastName": "اسکورسیزی" ,
"reasonDescription": "1",
"merchantName": "آقای پذیرا",
"merchantIban": "IR120620000000302876733006"
}
````````````````
| نام فیلد | توضیحات | بانک کشاورزی | بانک آینده | بانک پارسیان | بانک پاسارگاد |
|-|-|-|-|-|-|
| **amount** | مبلغ انتقال وجه | اجباری | اجباری | اجباری | اجباری |
| **description** | شرح انتقال وجه (حداکثر ۳۰ کاراکتر) | اجباری | اجباری | اجباری | اجباری |
| **destinationFirstname** | نام صاحب حساب مقصد (حداقل ۲ و حداکثر ۳۰ کاراکتر) برای انتقال پایا و ساتنا | اجباری | اجباری | اجباری | اجباری |
| **destinationLastname** | نام خانوادگی صاحب حساب مقصد (حداقل ۲ و حداکثر ۳۰ کاراکتر) برای انتقال پایا و ساتنا | اجباری | اجباری | اجباری | اجباری |
| **destinationNumber** | شماره حساب مقصد که میتواند شماره حساب بانکی یا شماره شبا(۲۶ کاراکتر) باشد (اگر شماره حساب شما در بانک شامل کاراکتر اضافه مانند خط تیره میباشد با همان فرمت در پارامتر استفاده کنید) | اجباری | اجباری | اجباری | اجباری |
| **paymentNumber** | شناسه پرداخت ,این عدد در صورتحساب شما و مشتریان درج میشود و میتواند عددی مانند شماره فاکتور و یا سند داخلی باشد (حداکثر ۳۰ رقم) | | اجباری | | |
| **reasonDescription** | بابت : [اطلاعات بیشتر](/doc/oak-reasonDescription.html?sandbox=+sandbox) | | اجباری | | |
| **deposit** | شماره حساب مبدا - درصورتی که توکن انتقال شامل چند حساب مبدا باشد از این فیلد استفاده می شود، در غیراینصورت حساب مبدا از توکن دریافت می شود | اجباری | | | |
| **sourceFirstName** | نام صاحب حساب مبدا برای انتقال پایا و ساتنا | اجباری | | | |
| **sourceLastName** | نام خانوادگی صاحب حساب مبدا برای انتقال پایا و ساتنا | اجباری | | | |
| **secondPassword** | رمز انتقال وجه | | | اجباری | |
| **merchantName** | نام پذیرنده (مربوط به بانک آینده) | | | | |
| **merchantIban** | شماره شبا پذیرنده (مربوط به بانک آینده) | | | | | |
#### Results Format
##### Successful result format (status code 200)
````````````````
{
"trackId": "transfer-to-deposit-0323",
"result": {
"amount": 1 ,
"description": "شرح تراکنش" ,
"destinationFirstname": "خلیلی حسینی بیابانی" ,
"destinationLastname": "سمیه غز اله فریماه" ,
"destinationNumber": "0201000900000" ,
"inquiryDate": "951217" ,
"inquirySequence": 1001 ,
"inquiryTime": "095554" ,
"message": " " ,
"paymentNumber": "12" ,
"refCode": "9611240622211448" ,
"sourceFirstname": "مهدی ز اده" ,
"sourceLastname": "امیر" ,
"sourceNumber": "0200900000000" ,
"type": "internal",
"reasonDescription": "19",
"transactionId": "1510-asf4973-098245893498872-1766",
"endToEndId": "654651236465132"
},
"status": "DONE"
}
````````````````
* **result:** آبجکتی از پاسخ سرویس شامل:
* **amount: ** مبلغ تراکنش
* **description: ** شرح تراکنش
* **destinationFirstname: ** نام صاحب حساب مقصد
* **destinationLastname: ** نام خانوادگی صاحب حساب مقصد
* **destinationNumber: ** شماره حساب مقصد
* **inquiryDate: ** این اطلاعات در صورت بروز مغایرت احتمالی برای رفع مغایرت باید به بانک ارایه گردد
* **inquiryTime: ** این اطلاعات در صورت بروز مغایرت احتمالی برای رفع مغایرت باید به بانک ارایه گردد
* **message: ** در صورتی بروز خطا، پیغام خطا در این فیلد قرار میگیرد
* **paymentNumber: ** شناسه پرداخت
* **refCode: ** کد پیگیری انتقال وجه
* **sourceFirstname: ** نام صاحب حساب مبدا
* **sourceLastname: ** نام خانوادگی صاحب حساب مبدا
* **sourceNumber: ** شماره حساب مبدا
* **reasonDescription: ** بابت
* **transactionId: ** کد تراکنش (فقط برای بانک پاسارگاد میباشد)
* **endToEndId: ** شناسه یکتای دریافت شده جهت تایید درخواست (فقط برای بانک پاسارگاد میباشد)
* **type: ** نوع انتقال وجه
* internal: انتقال وجه داخلی
* paya: انتقال وجه پایا
* **status: ** وضعیت فراخوانی سرویس
* DONE: فراخوانی موفق سرویس
* FAILED: فراخوانی ناموفق سرویس
* **error:** جزییات خطا (در صورت بروز خطا)
* **trackId: ** کد پیگیری که در فراخوانی سرویس فرستاده شده است
#### UnSuccessful result format
* در صورتی که در هنگام انتقال وجه حساب مقصد و حساب روی توکن شما یکسان باشد: (status code 400)
````````````````
{
"status": "FAILED" ,
"trackId": "TrackId" ,
"error": {
"code": "VALIDATION_ERROR" ,
"message": "Source And destination accounts are the same!"
}
}
````````````````
* در صورتی که مبلغ از مقدار تعریف شده هنگام گرفتن توکن بالاتر باشد: (status code 400)
````````````````
{
"status": "FAILED" ,
"trackId": "TrackId" ,
"error": {
"code": "VALIDATION_ERROR" ,
"message": "Max amount per transaction limitation exceeded"
}
}
````````````````
* در صورتی که شرایط برداشت حساب شما (در هنگام انتقال وجه مثل سرویس واریز و شارژ بنکارت) رعایت نشده باشد: (status code 400)
````````````````
{
"status": "FAILED" ,
"trackId": "TrackId" ,
"error": {
"code": "VALIDATION_ERROR" ,
"message": "account conditions not passed"
}
}
````````````````
* برای مثال در سرویس **انتقال وجه **، در صورتیکه مبلغ تراکنش واریز از نوع پایا کمتر از 10000 ریال باشد با خطای زیر روبرو میشوید:
````````````````
"result": {
"response": null,
"status": "FAILED",
"error": {
"code": "SERVICE_CALL_ERROR",
"message": "Minimum amount is 10000 Rials. "
}
}
````````````````
در اینجا میتوانید لیست خطاهای سرویس ها را مشاهده کنید [لیست خطاها](/doc/generic-errors.html)