/app/kyc/entity/rep

该接口用于在企业KYB流程中添加新的代表人(Representative)信息。通过提交代表人的个人基本信息、联系方式、地址信息以及相关证明文件,完成企业关键人员(如董事、高管、实际控制人等)的身份信息采集。

注意:最多只能添加两个代表,否则返回:

{
  "request_id": "a8eef6529f82bce68ed8b1853c6927e1",
  "status": "fail",
  "code": "910002",
  "message": "data failed, please try again.",
  "data": [],
  "metadata": {}
}

请求参数说明

基础参数

字段名类型必填说明
uidstring用户ID,用于标识当前操作的企业用户
uuidstring如果传表示修改,为空表示新增

个人信息

字段名类型必填说明
first_namestring
middle_namestring中间名
last_namestring
aliasesstring别名/曾用名
positionstring职位名称,如:Chief Executive Officer(首席执行官)
date_of_birthstring出生日期,格式:YYYY-MM-DD
place_of_birthstring出生地点
nationalityarray国籍列表,使用ISO 3166-1 alpha-2国家代码
emailstring电子邮箱
is_critical_rolestring是否为关键职位,可选值:Yes/No
related_officerstring是否关联高管,可选值:Yes/No

联系方式

字段名类型必填说明
phoneobject电话号码对象

phone对象结构

字段名类型必填说明
phone_country_codestring电话国家代码(带+号),如:+1
phone_country_code_shortstring电话国家代码(短格式),如:US
phone_numberstring电话号码

地址信息

字段名类型必填说明
countrystring国家代码,如:US
statestring州/省,如:CA(加利福尼亚州)
citystring城市,如:San Francisco
zipcodestring邮政编码,如:94102
address_1string地址第一行(详细街道地址)
address_2string地址第二行(补充信息,如公寓号、楼层等)

证明文件

1. 身份证明文件 (id_file)

字段名类型必填说明
file_hashstring文件唯一标识ID

2. 自拍照文件 (selfie_file)

字段名类型必填说明
file_hashstring文件唯一标识ID

3. 居住证明文件 (proof_of_residence_file)

字段名类型必填说明
file_hashstring文件唯一标识ID
file_categorystring证明类型,包含枚举:'utility_bill', 'bank_statement', 'credit_card_statement', 'lease_or_rental_agreement', 'mortgage_statement', 'mobile_bill'

请求示例

{
  "uid": "1123456",
  "first_name": "Tom",
  "middle_name": "Michael",
  "last_name": "Smith",
  "aliases": "Johnny",
  "position": "Chief Executive Officer",
  "date_of_birth": "1985-06-15",
  "place_of_birth": "US",
  "nationality": ["US", "JP"],
  "email": "[email protected]",
  "phone": {
    "phone_country_code": "+1",
    "phone_country_code_short": "US",
    "phone_number": "4155550101"
  },
  "country": "US",
  "state": "CA",
  "city": "San Francisco",
  "zipcode": "94102",
  "address_1": "123 Main Street, Apartment 5B",
  "address_2": "Building A",
  "is_critical_role": "Yes",
  "related_officer": "No",
  "id_file": [
    {
      "file_hash": "76fbf2b81341e4fd3bd9ce9a395fa54f"
    }
  ],
  "selfie_file": [
    {
      "file_hash": "70580af1292c0d4c43bbc408798c4a36"
    }
  ],
  "proof_of_residence_file": [
    {
      "file_hash": "70580af1292c0d4c43bbc408798c4a36",
      "file_category":"utility_bill",
    }
  ]
}

使用说明

  1. 数据完整性:建议在提交前对必填字段进行验证,确保信息完整
  2. 文件上传:通常文件需要先通过专门的上传接口获取file_id和file_url,然后再提交代表人信息
  3. 关键角色标识:is_critical_role为"Yes"表示该人员为企业关键人员(如董事、实际控制人),可能需要额外的合规审查
Responses

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