<![CDATA[
###Post /kyc/v2/clients/{clientId}/defineCustomerAccountUploadMedias
* **شرح:** در این مرحله مدارک هویتی از مشتری دریافت می گردد و در خروجی استعلام احراز هویت نمایش داده می شود. در ادامه توضیحات برای دریافت چهار مدرک روی کارت ملی، پشت کارت ملی, تصویر امضا و ویدئوی فرد آورده شده است. لازم به توضیح است ترتیب ارسال مدارک دارای اولویت نیست. لازم به ذکر است این سرویس از یازده شب تا هفت صبح در دسترسی نمیباشد.
* **اسکوپ: ** ``` kyc:define-customer-account-upload-media:post```
* **رویکرد: ** ``` CLIENT-CREDENTIAL```
* **<a href="Responsecodes.pdf"> دانلود مستندات ریسپانس کد ها</a> **
````````````````
{address}/kyc/v2/clients/{clientId}/defineCustomerAccountUploadMedias?trackId={trackid}
````````````````
<div class="sandboxaddress sandbox" id="sandbox" style="float:right" style="display: none" >
https://sandboxapi.finnotech.ir <b> :address </b>
</div>
<div class="production-address production" style="float:right" style="display: block">
https://apibeta.finnotech.ir <b> :address </b>
</div>
#### Headers
مقادیر زیر باید در هدر قرار بگیرد
````````````````
Authorization : Bearer {Token}
````````````````
#### URI Parameters
* **clientId:**شناسه کلاینت
#### Query Parameters
* **trackId :** (اجباری) ‫ رشته ای با طول حداکثر ۴۰ کاراکتر شامل حرف و عدد. پیشنهاد 2ما برای trackId تولید کردن UUID است. در صورت نیاز به نتیجه یک فراخوانی میتوانید با trackId آن را فیلتر کنید. در گزارش فراخوانی سرویس فراخوانی مورد نظر را با همین کد پیگیری پیدا میکنید.
* example: ```ef226c90-20cc-48c6-b582-dee29e71676a```
#### Body
##### Example:
````````````````
uploadCardFront مدل ورودی برای تایپ
"{
--form cardFront=cardfront.jpg \
--form defineCustomerTrackId= defineCustomerTrackId \
--form type=uploadCardFront
}"
uploadCardBack مدل ورودی برای تایپ
"{
--form cardBack=cardBack.jpg \
--form defineCustomerTrackId= defineCustomerTrackId \
--form type=uploadCardBack
}"
uploadSignature مدل ورودی برای تایپ
"{
--form signature=signature.jpg \
--form defineCustomerTrackId= defineCustomerTrackId \
--form type=uploadSignature\
--form threshold=0.6\
}"
uploadVideo مدل ورودی برای تایپ
"{
--form vid=video.mp4 \
--form defineCustomerTrackId= defineCustomerTrackId \
--form type=uploadVideo\
--from textSpeech=text
}"
````````````````
* **cardFront: ** تصویر روی کارت ملی ( فرمت این فایل حتما بایستی jpg باشد)
* **cardBack: ** تصویر پشت کارت ملی ( فرمت این فایل حتما بایستی jpg باشد)
* **signature: ** تصویر امضای شخص ( فرمت این فایل حتما بایستی jpg باشد)
* **threshold: ** میزان حساس بودن امضا (اختیاری - مقدار پیش فرض 0.5 میباشد)
* **vid: ** ویدیوی زنده‌ی کاربر ( فرمت این فایل حتما بایستی mp4 باشد)
* **defineCustomerTrackId: ** کدپیگیری درخواست افتتاح حساب مشتری
* **type: ** نوع درخواست ، که در یکی از چهار مقدار ذکر شده در مثال بدنه‌ی درخواست میباشد
#### Successful result format (status code 200)
````````````````
در صورتی تایپ ورودی شما عکس رو یا عکس پشت کارت ملی باشد خروجی سرویس به شکل زیر است:
"{
responseCode: FN-BRFH-20000810000
,
trackId: 3e35adb9-0164-4d5jjj6-9259-70024eff51c9,
nationalCode: 0000000000,
firstName: علی,
lastName: رحمانی,
fatherName: محمد,
birthDate: 1398/11/02
status: DONE
}"
در صورتی تایپ ورودی شما ویدیو باشد خروجی سرویس به شکل زیر است:
"{
trackId: 3e35adb9
faceVerification: 0.9952445 ,
liveness: 0.950000 ,
speechSimilarity: 0.852236,
accepted: true/false
status: DONE
}"
در صورتی تایپ ورودی شما عکس امضا باشد خروجی سرویس به شکل زیر است:
"{
responseCode: FN-BRFH-20000810000
,
trackId: 3e35adb9-0164-4d5jjj6-9259-70024eff51c9,
accepted: true,
status: DONE
}"
````````````````
* **responseCode:** کد پاسخ دریافتی
* ** result:** آبجکتی از پاسخ سرویس شامل:
* ** DONE:** فراخوانی موفق سرویس
* ** FAILED:** فراخوانی ناموفق سرویس
* ** nationalCode:** کدملی دارنده ی حساب
* ** firstname:** نام
* ** lastname:** نام خانوادگی
* ** fatherName:** نام پدر
* ** birthDate:** تاریخ تولد
* ** status:** وضعیت فراخوانی سرویس
* ** faceVerification:** درصد تطبیق چهره که بازه‌ی مورد قبول به صورت کلی بالای ۵۰ درصد است
* ** liveness:** میزان لایو بودن که بازه‌ی مورد قبول به صورت کلی بالای ۵۰ درصد است
* ** speechSimilarity:** درصد تشابه متن خوانده شده در ویدئو و متن دریافتی در ورودی سرویس که بازه‌ی مورد قبول به صورت کلی بالای ۵۰ درصد است
* ** accepted:** پیام خروجی
* ** trackId:** کد پیگیری که در فراخوانی سرویس فرستاده شده است.
* ** status:** ‫ DONE/FAILED
* ** error:** جزییات خطا (در صورت بروز خطا)
* **code:** استاتوس کد
* **message:** پیغام خطا
]]>