/kyc/individual/file

文件上传API,用于上传用户证件或证明文件


接口详情

上传个人验证文件,此接口需针对每个文件单独调用,不支持批量上传。

调用说明

请为每一个文件单独调用一次本接口。

支持的文件格式

类型允许的扩展名允许的 MIME 类型
图片jpeg, jpg, png, bmp, tiff, heif, heic, webpimage/jpeg, image/jpg, image/png, image/bmp, image/tiff, image/heif, image/heic, image/webp
文档pdfapplication/pdf

文件大小限制

  • PDF 文件:最大不得超过 20 MB。
  • 图片文件:最大不得超过 17 MB。

多次上传规则

同一 file_type 允许重复上传。系统将保留最后一次上传的文件,并自动覆盖此前上传的同类型文件。

请按以下要求上传文件

驾照与身份证:必须同时上传正面与背面,文件格式须为图片,不接受 PDF。

护照、居住证明及地址证明:仅需上传正面,文件格式须为图。

本人自拍照:仅需上传正面清晰照片。

居住地址证明:可上传图片或 PDF 格式 的文件。

file_type 类型定义

KeyRequiredDescription
id_fileYesPassport, ID Card, Resident Permit, or Driver's license.(Images only please, PDF not accepted.)
id_back_fileYesBack of the ID document (e.g. the back of Driver's License, ID Card. Images only please, PDF not accepted.) This is optional, as passport doesn't have a back side.
selfie_fileYesPhoto of the userself, with the entire face visible. Remove any accessories such as glasses when taking the selfie. Photo should be well lit and in focus.
proof_of_addressYesProof of address - Utility bills. Supported formats JPG, JPEG, PNG and PDF.
Please specify the file_category for the proof of address, if available.
Query Params
string
required

Unique user id

string
required
Defaults to selfie

File Name

string
enum
required
Defaults to selfie_file

id_file, id_back_file, selfie_file, proof_of_address

Allowed:
string
enum

Specify the document category

Allowed:
string
required
Defaults to /path/to/file/SampleJPGImage_50kb.jpg

File, allowed extensions: jpeg, bmp,png,tiff,pdf,jpg

Headers
string
required
Defaults to 12.34.56.78

User's most recent access/login IP address

string
Defaults to 39630
Responses

Language
Credentials
http
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json