修改实名信息v2

请求URL
请求参数
加密数据dataContent
information 数据
1-境内个人
2-境内企业
3-香港企业
5-其他地区企业
董事信息directorList
受益人信息beneficiaryList
响应参数
结果信息result

请求URL

POST {域名}/api/v2/agent/user/certification-edit

请求参数

👉说明：

请求参数详见 请求报文

加密数据dataContent

序号	域名	变量名	必填	长度	备注
01.	用户编号	userNo	M	Number	GEP提供给用户的唯一编号
02.	实名信息	information	M	Object	根据不同用户类型传入不同对象数据，具体参数如下
03.	回调地址	callBackUrl	O	String(64)	实名认证审核结果通知

information 数据

1-境内个人

证件到期：身份证号码不可更改，变更无效

序号	域名	变量名	必填	长度	备注
01.	身份证照片（人像面）	idFront	M	Number	上传文件接口返回的FileId（上传文件接口的fileType：ID_FRONT_REAL_NAME）
02.	身份证照片（国徽面）	idReverse	M	Number	上传文件接口返回的FileId（上传文件接口的fileType：ID_REVERSE_REAL_NAME）
03.	手持身份证	idHold	M	Number	上传文件接口返回的FileId（上传文件接口的fileType：ID_HOLD_REAL_NAME）
04.	身份证号码	idNo	M	String(18)
05.	姓名	name	M	String(128)
06.	First Name	firstName	M	String(64)	不允许包含中文字符
07.	Last Name	lastName	M	String(64)	不允许包含中文字符
08.	身份证有效期	legalCertExpiryDate	M	String(10)	格式 YYYY-MM-DD
09.	出生日期	birthDate	M	String(10)	格式 YYYY-MM-DD
10.	住所地址(省)	province	M	String(32)	格式必须是code_name 如：210000_辽宁省省市区编码详见附件
11.	住所地址(市)	city	M	String(32)	格式必须是code_name 如：210200_大连市省市区编码详见附件
12.	住所地址(区)	area	O	String(32)	格式必须是code_name 如：210202_中山区省市区编码详见附件
13.	住所地址(详细地址)	address	M	String(128)
14.	邮编	postCode	O	String(6)	默认根据住所地址获取

2-境内企业

证件到期：营业执照号不可更改，变更无效

序号	域名	变量名	必填	长度	备注
01.	营业执照照片	license	M	Number	上传文件接口返回的FileId（上传文件接口的fileType：LICENSE_REAL_NAME）
02.	营业执照号	licenseNo	M	String(18)
03.	企业名称	name	M	String(128)
04.	企业英文名称	enName	M	String(128)	仅支持填写数字英文字母,.()-‘单个空格,请将&符号用and替换
05.	公司类型	companyType	M	String(128)
06.	注册地址(省)	registerProvince	M	String(32)	格式必须是code_name 如：210000_辽宁省省市区编码详见附件
07.	注册地址(市)	registerCity	M	String(32)	格式必须是code_name 如：210200_大连市省市区编码详见附件
08.	注册地址(区)	registerArea	O	String(32)	格式必须是code_name 如：210202_中山区省市区编码详见附件
09.	注册地址(详细地址)	registerAddress	M	String(128)	不能包含换行符
10.	法定代表人	legalRepresentative	M	String(128)	与法人姓名一致
11.	注册资本(万元)	registerAmt	M	Number
12.	成立日期	registerDate	M	String(10)	格式 YYYY-MM-DD
13.	营业期限	endDate	M	String(10)	格式 YYYY-MM-DD
14.	经营范围	managementScope	M	String(512)
15.	经营地址(省)	province	M	String(32)	格式必须是code_name 如：210000_辽宁省省市区编码详见附件
16.	经营地址(市)	city	M	String(32)	格式必须是code_name 如：210200_大连市省市区编码详见附件
17.	经营地址(区)	area	O	String(32)	格式必须是code_name 如：210202_中山区省市区编码详见附件
18.	经营地址(详细地址)	address	M	String(128)	不能包含换行符
19.	行业类型	industryId	O	String(4)	详见附件
20.	经济类型	economyId	O	String(3)	详见附件
21.	邮编	postcode	O	String(6)	默认根据注册地址获取
22.	法人证件类型	legalIdType	M	Number	法代、受益人、董事等企业相关人员角色的不同国籍需对应不同证件类型 CHN(中国): 1-中国大陆二代身份证； HKG(中国香港): 2-护照 3-香港永久性居民身份证 4-香港居民身份证；其他国家: 2-护照 5-公民身份证；
23.	法人证件照正面	legalIdFront	M	Number	上传文件接口返回的FileId（上传文件接口的fileType：ID_FRONT_REAL_NAME）
24.	法人证件照反面	legalIdReverse	O	Number	上传文件接口返回的FileId（上传文件接口的fileType：ID_REVERSE_REAL_NAME）证件类型为1时必填
25.	法人手持证件照	legalIdHold	M	Number	上传文件接口返回的FileId（上传文件接口的fileType：ID_HOLD_REAL_NAME）
26.	法人证件号	legalIdNo	M	String(18)
27.	法人姓名	legalName	M	String(128)	与法定代表人一致
28.	法人First Name	legalFirstName	M	String(64)	不允许包含中文字符
29.	法人Last Name	legalLastName	M	String(64)	不允许包含中文字符
30.	法人性别	legalGender	O	Number	证件类型为1时以证件号解析为准,其他证件类型必填 1-男 2-女
31.	法人出生日期	legalBirthDate	M	String(10)	格式 YYYY-MM-DD
32.	法人证件有效期	legalCertExpiryDate	M	String(10)	格式 YYYY-MM-DD
33.	法人常住地址(省)	legalProvince	M	String(32)	格式必须是code_name 如：210000_辽宁省省市区编码详见附件
34.	法人常住地址(市)	legalCity	M	String(32)	格式必须是code_name 如：210200_大连市省市区编码详见附件
35.	法人常住地址(区)	legalArea	O	String(32)	格式必须是code_name 如：210202_中山区省市区编码详见附件
36.	法人常住地址(地址)	legalAddress	M	String(128)	不能包含换行符
37.	法人国籍	legalCountryCode	M	String(3)	国家3位编码
38.	受益人信息	beneficiaryList	M	List	见下方受益人信息beneficiaryList
39.	代理人证件类型	businessIdType	O	Number	法代、受益人、董事等企业相关人员角色的不同国籍需对应不同证件类型 CHN(中国): 1-中国大陆二代身份证； HKG(中国香港): 2-护照 3-香港永久性居民身份证 4-香港居民身份证；其他国家: 2-护照 5-公民身份证；
40.	代理人证件照正面	businessIdFront	O	Number	上传文件接口返回的FileId（上传文件接口的fileType：ID_FRONT_REAL_NAME
41.	代理人证件照反面	businessIdReverse	O	Number	上传文件接口返回的FileId（上传文件接口的fileType：ID_REVERSE_REAL_NAME）证件类型为1时必填
42.	代理人证件号码	businessIdNo	O	String(18)
43.	代理人姓名	businessName	O	String(128)
44.	代理人性别	businessGender	O	Number	证件类型为1时以证件号解析为准,其他证件类型必填 1-男 2-女
45.	代理人出生日期	businessBirthDate	O	String(10)	格式 YYYY-MM-DD
46.	代理人证件有效期	businessIdExpiryDate	O	String(10)	格式 YYYY-MM-DD
47.	代理人企业授权书	businessPowerOfAttorney	O	Number	上传文件接口返回的FileId（上传文件接口的fileType：POWER_OF_ATTORNEY_REAL_NAME）
48.	代理人国籍	businessCountry	O	String(3)	国家3位编码

3-香港企业

证件到期：注册证书编号不可更改，变更无效

序号	域名	变量名	必填	长度	备注
01.	商业登记证	businessRegister	M	Number	上传文件接口返回的FileId（上传文件接口的fileType：BUSINESS_REGISTER_REAL_NAME）
02.	周年申报表	declarationForm	O	Number	上传文件接口返回的FileId（上传文件接口的fileType：DECLARATION_FORM_REAL_NAME）公司注册满一年需提供周年申报表
03.	周年审核有效期	declarationDate	O	String(10)	格式 YYYY-MM-DD 周年申报表有效期=申报表的结算日期+1年，如结算日期为2025-01-01，则有效期为2026-01-01。
04.	法团成立表	incorporationForm	M	Number	上传文件接口返回的FileId（上传文件接口的fileType：INCORPORATION_FORM_REAL_NAME）
05.	注册证书	orgRegister	M	Number	上传文件接口返回的FileId（上传文件接口的fileType：ORG_REGISTER_REAL_NAME）
06.	股权架构	stockCertificate	O	Number	上传文件接口返回的FileId（上传文件接口的fileType：STOCK_CERTIFICATE_REAL_NAME）
07.	企业名称	name	M	String(128)
08.	企业英文名称	enName	M	String(128)	仅支持填写数字英文字母,.()-‘单个空格,请将&符号用and替换
09.	注册证书编号	orgRegisterNo	M	String(32)
10.	商业登记号码	businessRegisterNo	M	String(32)
11.	商业登记证有效期	businessRegisterExpiryDate	M	String(10)	格式 YYYY-MM-DD
12.	成立日期	registerDate	M	String(10)	格式 YYYY-MM-DD
13.	注册资本(港元)	registerAmt	M	Number
14.	注册地址(省)	registerProvince	M	String(32)	格式必须是code_name 如：210000_辽宁省省市区编码详见附件
15.	注册地址(市)	registerCity	M	String(32)	格式必须是code_name 如：210200_大连市省市区编码详见附件
16.	注册地址(区)	registerArea	O	String(32)	格式必须是code_name 如：210202_中山区省市区编码详见附件
17.	注册地址(详细地址)	registerAddress	M	String(128)	不能包含换行符
18.	经营地址(省)	province	M	String(32)	格式必须是code_name 如：210000_辽宁省省市区编码详见附件
19.	经营地址(市)	city	M	String(32)	格式必须是code_name 如：210200_大连市省市区编码详见附件
20.	经营地址(区)	area	O	String(32)	格式必须是code_name 如：210202_中山区省市区编码详见附件
21.	经营地址(详细地址)	address	M	String(128)	不能包含换行符
22.	董事信息	directorList	M	List	见下方董事信息directorList
23.	受益人信息	beneficiaryList	M	List	见下方受益人信息beneficiaryList
24.	代理人证件类型	businessIdType	O	Number	法代、受益人、董事等企业相关人员角色的不同国籍需对应不同证件类型 CHN(中国): 1-中国大陆二代身份证； HKG(中国香港): 2-护照 3-香港永久性居民身份证 4-香港居民身份证；其他国家: 2-护照 5-公民身份证；
25.	代理人证件照正面	businessIdFront	O	Number	上传文件接口返回的FileId（上传文件接口的fileType：ID_FRONT_REAL_NAME
26.	代理人证件照反面	businessIdReverse	O	Number	上传文件接口返回的FileId（上传文件接口的fileType：ID_REVERSE_REAL_NAME）证件类型为1时必填
27.	代理人证件号码	businessIdNo	O	String(18)
28.	代理人姓名	businessName	O	String(128)
29.	代理人性别	businessGender	O	Number	证件类型为1时以证件号解析为准,其他证件类型必填 1-男 2-女
30.	代理人出生日期	businessBirthDate	O	String(10)	格式 YYYY-MM-DD
31.	代理人证件有效期	businessIdExpiryDate	O	String(10)	格式 YYYY-MM-DD
32.	代理人企业授权书	businessPowerOfAttorney	O	Number	上传文件接口返回的FileId（上传文件接口的fileType：POWER_OF_ATTORNEY_REAL_NAME）
33.	代理人国籍	businessCountry	O	String(3)	国家3位编码

5-其他地区企业

证件到期：注册证书编号不可更改，变更无效

序号	域名	变量名	必填	长度	备注
01.	注册证书	orgRegister	M	Number	上传文件接口返回的FileId（上传文件接口的fileType：ORG_REGISTER_REAL_NAME）
02.	其他附件	otherAccessories	M	Number	上传文件接口返回的FileId（上传文件接口的fileType：OTHER_ACCESSORIES_REAL_NAME）
03.	企业注册地	registerCountry	M	String(3)	国家3位编码
04.	企业名称	name	M	String(128)
05.	企业英文名称	enName	M	String(128)	仅支持填写数字英文字母,.()-‘单个空格,请将&符号用and替换
06.	注册证书编号	orgRegisterNo	M	String(32)
07.	成立日期	registerDate	M	String(10)	格式 YYYY-MM-DD
08.	注册资本	registerAmt	M	Number
09.	注册地址(省/州)	registerProvince	M	String(64)
10.	注册地址(城市)	registerCity	M	String(64)
11.	注册地址(详细地址)	registerAddress	M	String(128)	不能包含换行符
12.	邮编	postCode	M	String(8)
13.	经营地址(省/州)	province	M	String(64)
14.	经营地址(城市)	city	M	String(64)
15.	经营地址(详细地址)	address	M	String(128)	不能包含换行符
16.	董事信息	directorList	M	List	见下方董事信息directorList
17.	受益人信息	beneficiaryList	M	List	见下方受益人信息beneficiaryList
18.	代理人证件类型	businessIdType	O	Number	法代、受益人、董事等企业相关人员角色的不同国籍需对应不同证件类型 CHN(中国): 1-中国大陆二代身份证； HKG(中国香港): 2-护照 3-香港永久性居民身份证 4-香港居民身份证；其他国家: 2-护照 5-公民身份证；
19.	代理人证件照正面	businessIdFront	O	Number	上传文件接口返回的FileId（上传文件接口的fileType：ID_FRONT_REAL_NAME
20.	代理人证件照反面	businessIdReverse	O	Number	上传文件接口返回的FileId（上传文件接口的fileType：ID_REVERSE_REAL_NAME）证件类型为1时必填
21.	代理人证件号码	businessIdNo	O	String(18)
22.	代理人姓名	businessName	O	String(128)
23.	代理人性别	businessGender	O	Number	证件类型为1时以证件号解析为准,其他证件类型必填 1-男 2-女
24.	代理人出生日期	businessBirthDate	O	String(10)	格式 YYYY-MM-DD
25.	代理人证件有效期	businessIdExpiryDate	O	String(10)	格式 YYYY-MM-DD
26.	代理人企业授权书	businessPowerOfAttorney	O	Number	上传文件接口返回的FileId（上传文件接口的fileType：POWER_OF_ATTORNEY_REAL_NAME）
27.	代理人国籍	businessCountry	O	String(3)	国家3位编码

董事信息directorList

序号	域名	变量名	必填	长度	备注
01.	董事证件类型	directorIdType	M	Number	法代、受益人、董事等企业相关人员角色的不同国籍需对应不同证件类型 CHN(中国): 1-中国大陆二代身份证； HKG(中国香港): 2-护照 3-香港永久性居民身份证 4-香港居民身份证；其他国家: 2-护照 5-公民身份证；
02.	董事证件照正面	directorIdFront	M	Number	上传文件接口返回的FileId（上传文件接口的fileType：ID_FRONT_REAL_NAME）
03.	董事证件照反面	directorIdReverse	O	Number	上传文件接口返回的FileId（上传文件接口的fileType：ID_REVERSE_REAL_NAME）证件类型为1时必填
04.	董事证手持证件照	directorIdHold	M	Number	上传文件接口返回的FileId（上传文件接口的fileType：ID_HOLD_REAL_NAME）
05.	董事证件号码	directorIdNo	M	String(18)
06.	董事姓名	directorName	M	String(128)
07.	董事First Name	directorFirstName	M	String(64)	不允许包含中文字符
08.	董事Last Name	directorLastName	M	String(64)	不允许包含中文字符
09.	董事性别	directorGender	O	Number	证件类型为1时以证件号解析为准,其他证件类型必填 1-男 2-女
10.	董事出生日期	directorBirthDate	M	String(10)	格式 YYYY-MM-DD
11.	董事证件有效期	directorCertExpiryDate	M	String(10)	格式 YYYY-MM-DD
12.	董事常住地址(省)	directorProvince	O	String(64)	香港企业：必填，格式必须是code_name 如：210000_辽宁省省市区编码详见附件; 其他地区企业：选填，格式文本
13.	董事常住地址(市)	directorCity	O	String(64)	香港企业：必填，格式必须是code_name 如：210200_大连市省市区编码详见附件其他地区企业：选填，格式文本
14.	董事常住地址(市)	directorArea	O	String(64)	香港企业：必填，格式必须是code_name 如：210202_中山区省市区编码详见附件其他地区企业：选填，格式文本
15.	董事常住地址(详细地址)	directorAddress	M	String(128)	不能包含换行符
16.	董事国籍	directorCountry	M	String(3)	国家3位编码

受益人信息beneficiaryList

序号	域名	变量名	必填	长度	备注
01.	受益人证件类型	beneficiaryIdType	M	Number	法代、受益人、董事等企业相关人员角色的不同国籍需对应不同证件类型 CHN(中国): 1-中国大陆二代身份证； HKG(中国香港): 2-护照 3-香港永久性居民身份证 4-香港居民身份证；其他国家: 2-护照 5-公民身份证；
02.	受益人证件照正面	beneficiaryIdFront	M	Number	上传文件接口返回的FileId（上传文件接口的fileType：ID_FRONT_REAL_NAME）
03.	受益人证件照反面	beneficiaryIdReverse	O	Number	上传文件接口返回的FileId（上传文件接口的fileType：ID_REVERSE_REAL_NAME）证件类型为1时必填
04.	受益人证件号码	beneficiaryIdNo	M	Number(18)
05.	受益人姓名	beneficiaryName	M	String(128)
06.	受益人First Name	beneficiaryFirstName	M	String(64)	不允许包含中文字符
07.	受益人Last Name	beneficiaryLastName	M	String(64)	不允许包含中文字符
08.	受益人性别	beneficiaryGender	O	Number	证件类型为1时以证件号解析为准,其他证件类型必填 1-男 2-女
09.	受益人出生日期	beneficiaryBirthDate	M	String(10)	格式 YYYY-MM-DD
10.	受益人证件有效期	beneficiaryCertExpiryDate	M	String(10)	格式 YYYY-MM-DD
11.	受益人常住地址(省)	beneficiaryProvince	O	String(64)	大陆企业、香港企业：必填，格式必须是code_name 如：210000_辽宁省省市区编码详见附件其他地区企业：选填，格式文本
12.	受益人常住地址(市)	beneficiaryCity	O	String(64)	大陆企业、香港企业：必填，格式必须是code_name 如：210200_大连市省市区编码详见附件其他地区企业：选填，格式文本
13.	受益人常住地址(市)	beneficiaryArea	O	String(64)	大陆企业、香港企业：格式必须是code_name 如：210202_中山区省市区编码详见附件其他地区企业：格式文本
14.	受益人常住地址(详细地址)	beneficiaryAddress	M	String(128)	不能包含换行符
15.	受益人持股比例	beneficiaryShareholderRatio	M	Number	多位加起来不能超过100%
16.	受益人国籍	beneficiaryCountry	M	String(3)	国家3位编码

dataContent示例

{
  "callBackUrl": "https://127.0.0.1:8080/gep/callBackUrl",
  "information": {
    "registerCity": "310100_上海市",
    "licenseNo": "916100007273444965",
    "beneficiaryIdNo": [
      "511303198809243078",
      "hz231312434"
    ],
    "beneficiaryIdType": [
      1,
      2
    ],
    "beneficiaryProvince": [
      "1310000_上海",
      "810000_香港特别行政区"
    ],
    "endDate": "2028-12-31",
    "city": "310100_上海市",
    "legalArea": "310101_黄浦区",
    "beneficiaryAddress": [
      "新码头街55号4幢3楼",
      "香港大世界"
    ],
    "legalAddress": "新码头街55号4幢3楼",
    "legalName": "测试甲",
    "legalIdReverse": 13147015,
    "legalRepresentative": "测试甲",
    "beneficiaryArea": [
      "310101_黄浦区",
      null
    ],
    "province": "310000_上海",
    "legalIdFront": 13147014,
    "beneficiaryCertExpiryDate": [
      "2028-12-02",
      "2024-12-31"
    ],
    "beneficiaryName": [
      "测试甲",
      "测试乙"
    ],
    "enName": "Test Org",
    "beneficiaryBirthDate": [
      "1988-09-24",
      "1980-05-19"
    ],
    "legalProvince": "310000_上海",
    "registerDate": "2020-01-01",
    "area": "310101_黄浦区",
    "address": "新码头街55号4幢3楼",
    "companyType": "有限责任公司(自然人投资或控股)",
    "legalIdType": 1,
    "legalCertExpiryDate": "2028-12-02",
    "legalBirthDate": "1988-09-24",
    "beneficiaryShareholderRatio": [
      55,
      25
    ],
    "legalIdNo": "511303198809243078",
    "legalCountryCode": "CHN",
    "beneficiaryIdFront": [
      13147014,
      13147014
    ],
    "legalCity": "310100_上海市",
    "registerProvince": "310000_上海",
    "registerCcy": "CNY",
    "license": 13147014,
    "beneficiaryCity": [
      "310100_上海市",
      "810300_新界东"
    ],
    "registerAddress": "新码头街55号4幢3楼",
    "beneficiaryCountry": [
      "CHN",
      "HKD"
    ],
    "legalIdHold": 13147016,
    "name": "测试企业科技有限公司",
    "registerArea": "310101_黄浦区",
    "registerAmt": 500,
    "beneficiaryIdReverse": [
      13147015,
      null
    ]
  },
  "userNo": 5181221108000500000,
  "userType": 2
}

响应参数

👉说明：

响应参数详见：响应报文

结果信息result

序号	域名	变量名	必填	字段类型	备注
01.	结果		M	Boolean	true

result示例

true

作者：陈花枪创建时间：2025-04-18 13:51
最后编辑：陈花枪更新时间：2025-05-26 15:03