###POST /oak/v2/clients/{clientId}/withdrawalFrom * **شرح: ** سرویس برداشت مستقیم از حساب دیگران, این سرویس هنگامی به کار می‌رود که شما قصد دارید از حساب مشتریان خود یکبار یا به صورت دوره‌ای وجهی را برداشت کنید. * **اسکوپ: ** ```oak:withdrawal-from:execute``` * **رویکرد: ** ```Authorization_Code``` <!-- * **رویکرد بانک کشاورزی: ** ```Client_Credential``` --> * **<a href="ResponseCodeOak.pdf"> دانلود مستندات ریسپانس کد ها</a> ** ```````````````` {address}/oak/v2/clients/{clientId}/withdrawalFrom?trackId={trackId} ```````````````` <div class="sandboxaddress sandbox" id="sandbox" style="float:right" style="display: none" > https://sandboxapi.finnotech.ir<b><span class="finnotech-sandbox-address-text"> :address </span></b> </div> <div class="production-address production" style="float:right" style="display: block"> https://apibeta.finnotech.ir <b> :address </b> </div> <br> * **سرویس‌های مرتبط :[گزارش پایا](/doc/oak-payas.html?sandbox=+sandbox/)** <br> * **سرویس‌های مرتبط :[پیگیری تراکنش](/doc/oak-transferInquiry.html?sandbox=+sandbox/)** <br> **سرویس‌های مرتبط : [پیگیری تراکنش](/doc/oak-transactionInquiry-get.html?sandbox=+sandbox/)** #### Notes‍ * &#x202b; بدینوسیله ساعات کاری سامانه های ساتنا و پایا از تاریخ 1398/12/12 تا اطلاع ثانوی به شرح زیر میباشد : * &#x202B; چرخه اول. 18.45 روز قبل تا 03.45 روز جاری ( تسویه 3.45 ) (بانک پارسیان این سیکل را پشتیبانی نمیکند) * &#x202b; چرخه دو. 03.45 روز جاری تا 10.45 روز جاری (تسویه 10.45) * &#x202b; چرخه سه. 10.45 روز جاری تا 13.45 روز جاری (تسویه 13.45) * &#x202b; چرخه چهار. 13.45 روز جاری تا 18.45 روز جاری (تسویه 17.45) * &#x202b; انتقال وجه داخلی به حساب / کارت آینده دقایقی بین ساعت 23:54 الی 00:00 که روز مالی بانک بسته می شود، غیرفعال است. * &#x202b; اگر فیلد وضعیت در پاسخ تراکنش داخلی «PENDING» یا «UNKNOWN» بود قبل از تلاش مجدد با فراخوانی [سرویس استعلام](/doc/oak-transferInquiry.html/) از آخرین وضعیت تراکنش اطمینان حاصل نمایید. * &#x202b; اگر فیلد وضعیت در پاسخ تراکنش بین بانکی(پایا) «PENDING» یا «UNKNOWN» بود قبل از تلاش مجدد با فراخوانی [سرویس گزارش پایا](/doc/oak-payas.html/) از آخرین وضعیت تراکنش اطمینان حاصل نمایید، توجه داشته باشید که تراکنش با یک سیکل تاخیر در این لیست برگردانده خواهد شد. * &#x202b; درصورت فرستادن چند کاراکتر (-) به هم پیوسته در شرح تراکنش خطا ورودی برگردانده می‌شود. #### Headers مقادیر زیر باید در هدر قرار بگیرد ```````````````` Content-Type: application/json Authorization : Bearer {Token} ```````````````` #### URI Parameters * **clientId:**شناسه کلاینت #### Query Parameters * **trackId :** (اجباری) &#x202b; رشته ای با طول حداکثر ۴۰ کاراکتر شامل حرف و عدد. پیشنهاد 2ما برای trackId تولید کردن UUID است. در صورت نیاز به نتیجه یک فراخوانی میتوانید با trackId آن را فیلتر کنید. در گزارش فراخوانی سرویس فراخوانی مورد نظر را با همین کد پیگیری پیدا میکنید. * example: ```withdraw-009``` #### Body * **example:** ```````````````` { "destinationNumber": "IR46056007950000562574001" , "destinationFirstname": "حاجی ز اده مقدم" , "destinationLastname": "علی" , "amount": 1 "paymentNumber": "1" , "description": "test", "deposit": "776792026" "secondPassword": "32308932", "reasonDescription": "1" } ```````````````` | نام فیلد | توضیحات | بانک کشاورزی | بانک آینده | بانک پارسیان| |-|-|-|-|-| | **destinationNumber** | شماره شبای یکی از حساب‌هایی که برای اپلیکیشن شما تایید شده است | اجباری | اجباری | اجباری | | **destinationFirstname** | نام صاحب حساب مقصد. حداکثر ۳۰ کاراکتر (این فیلد در انتقال وجه پایا اجباری است) | اجباری | اجباری | اجباری | | **destinationLastname** | نام‌خانوادگی صاحب حساب مقصد. حداکثر ۳۰ کاراکتر (این فیلد در انتقال وجه پایا اجباری است) | اجباری | اجباری | اجباری | | **amount** | مبلغ انتقال وجه | اجباری | اجباری | اجباری | | **paymentNumber** | شناسه پرداخت | اجباری | اجباری | اجباری | | **reasonDescription** | بابت : [اطلاعات بیشتر](/doc/oak-reasonDescription.html?sandbox=+sandbox) | | اجباری | | | **description** | شرح انتقال وجه - حداکثر ۳۰ کاراکتر | اجباری | اجباری | اجباری | | **deposit** | شماره حساب مبدا | اجباری | | | | **secondPassword** | رمز انتقال وجه | | | اجباری | ###Results Format #### Successful result format (status code 200) ```````````````` { "result": { "amount": "1" , "description": "تست" , "destinationFirstname": "حاجی ز اده مقدم" , "destinationLastname": "علی" , "destinationNumber": "6795562574001" , "inquiryDate": "951217" , "inquirySequence": 1002 , "inquiryTime": "100218" , "message": " " , "paymentNumber": "123456" , "refCode": "951217100218KARZ1002" , "sourceFirstname": "مهدی ز اده" , "sourceLastname": "امیر" , "sourceNumber": "0200935673008", "reasonDescription": "1" }, "status": "DONE" , "trackId": "withdraw-009" } ```````````````` * **result:** آبجکتی از پاسخ سرویس شامل: * **amount: ** مبلغ تراکنش * **description: ** شرح انتقال وجه (در ریسپانس بانک کشاورزی خالی است) * **destinationFirstname: ** نام صاحب حساب مقصد * **destinationLastname: ** نام خانوادگی صاحب حساب مقصد * **destinationNumber: ** شماره حساب مقصد * **inquiryDate: ** این اطلاعات در صورت بروز مغایرت احتمالی برای رفع مغایرت باید به بانک ارایه گردد * **inquirySequence: ** این اطلاعات در صورت بروز مغایرت احتمالی برای رفع مغایرت باید به بانک ارایه گردد * **inquiryTime: ** این اطلاعات در صورت بروز مغایرت احتمالی برای رفع مغایرت باید به بانک ارایه گردد * **message: ** در صورت بروز خطا در انتقال وجه شامل پیغام خطا خواهد بود * **paymentNumber: ** شناسه پرداخت (در ریسپانس بانک کشاورزی برگردانده نمی شود) * **refCode: ** کد پیگیری انتقال وجه (در ریسپانس بانک کشاورزی برگردانده نمی شود) * **sourceFirstname: ** نام صاحب حساب مبدا (در ریسپانس بانک کشاورزی برگردانده نمی شود) * **sourceLastname: ** نام صاحب حساب مبدا (در ریسپانس بانک کشاورزی برگردانده نمی شود) * **reasonDescription: ** بابت * **sourceNumber: ** شماره حساب مبدا (در ریسپانس بانک کشاورزی برگردانده نمی شود) * **status: ** وضعیت فراخوانی سرویس * DONE: فراخوانی موفق سرویس * FAILED: فراخوانی ناموفق سرویس * **error:** جزییات خطا (در صورت بروز خطا) * **trackId: ** کد پیگیری که در فراخوانی سرویس فرستاده شده است #### UnSuccessful result format در اینجا میتوانید لیست خطاهای سرویس ها را مشاهده کنید [لیست خطاها](/doc/generic-errors.html)