修改实名信息

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

请求URL

POST {域名}/api/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-境内企业

受益人信息：支持多位，参数为数组，非必填数据可传null进行占位
代理人信息：可为空，如果填写其中一项，其余项必填
证件到期：营业执照号不可更改，变更无效

序号	域名	变量名	必填	长度	备注
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.	注册币种	registerCcy	M	String(3)	固定值：CNY
13.	成立日期	registerDate	M	String(10)	格式 YYYY-MM-DD
14.	营业期限	endDate	M	String(10)	格式 YYYY-MM-DD
15.	经营范围	managementScope	M	String(1024)
16.	经营地址(省)	province	M	String(32)	格式必须是code_name 如：210000_辽宁省省市区编码详见附件
17.	经营地址(市)	city	M	String(32)	格式必须是code_name 如：210200_大连市省市区编码详见附件
18.	经营地址(区)	area	O	String(32)	格式必须是code_name 如：210202_中山区省市区编码详见附件
19.	经营地址(详细地址)	address	M	String(128)
20.	行业类型	industryId	O	String(4)	详见附件
21.	经济类型	economyId	O	String(3)	详见附件
22.	邮编	postcode	O	String(6)	默认根据注册地址获取
23.	法人证件类型	legalIdType	M	Number	CHN(中国): 1-中国大陆二代身份证； HKG(中国香港): 2-护照/3-香港永久性居民身份证/4-香港居民身份证；其他国家传: 2-护照/5-公民身份证；注：会根据用户国籍验证对应类型，请按要求填写
24.	法人证件照正面	legalIdFront	M	Number	上传文件接口返回的FileId（上传文件接口的fileType：ID_FRONT_REAL_NAME）
25.	法人证件照反面	legalIdReverse	O	Number	上传文件接口返回的FileId（上传文件接口的fileType：ID_REVERSE_REAL_NAME）,证件类型为1时必填
26.	法人手持证件照	legalIdHold	M	Number	上传文件接口返回的FileId（上传文件接口的fileType：ID_HOLD_REAL_NAME）
27.	法人证件号	legalIdNo	M	String(18)
28.	法人姓名	legalName	M	String(128)	与法定代表人一致
29.	法人First Name	legalFirstName	M	String(64)	不允许包含中文字符
30.	法人Last Name	legalLastName	M	String(64)	不允许包含中文字符
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.	受益人信息证件类型	beneficiaryIdType	M	Number[]	CHN(中国): 1-中国大陆二代身份证； HKG(中国香港): 2-护照/3-香港永久性居民身份证/4-香港居民身份证；其他国家传: 2-护照/5-公民身份证；注：会根据用户国籍验证对应类型，请按要求填写
39.	受益人信息证件照正面	beneficiaryIdFront	M	Number[]	上传文件接口返回的FileId（上传文件接口的fileType：ID_FRONT_REAL_NAME
40.	受益人信息证件照反面	beneficiaryIdReverse	M	Number[]	上传文件接口返回的FileId（上传文件接口的fileType：ID_REVERSE_REAL_NAME）,可传null进行占位,证件类型为1时必填
41.	受益人信息证件号码	beneficiaryIdNo	M	String[]
42.	受益人信息姓名	beneficiaryName	M	String[]
43.	受益人信息First Name	beneficiaryFirstName	M	String[]	不允许包含中文字符
44.	受益人信息Last Name	beneficiaryListName	M	String[]	不允许包含中文字符
45.	受益人信息出生日期	beneficiaryBirthDate	M	String[]	格式 YYYY-MM-DD
46.	受益人信息证件有效期	beneficiaryCertExpiryDate	M	String[]	格式 YYYY-MM-DD
47.	受益人信息常住地址(省)	beneficiaryProvince	M	String[]	格式必须是code_name 如：210000_辽宁省省市区编码详见附件
48.	受益人信息常住地址(市)	beneficiaryCity	M	String[]	格式必须是code_name 如：210200_大连市省市区编码详见附件
49.	受益人信息常住地址(区)	beneficiaryArea	M	String[]	格式必须是code_name 如：210202_中山区省市区编码详见附件,可传null进行占位
50.	受益人信息常住地址(详细地址)	beneficiaryAddress	M	String[]
51.	受益人信息持股比率	beneficiaryShareholderRatio	M	Number[]	多位加起来不能超过100%
52.	受益人信息国籍	beneficiaryCountry	O	String[]	国家3位编码
53.	代理人信息证件类型	businessIdType	O	Number	1-身份证 2-护照
54.	代理人信息证件照正面	businessIdFront	O	Number	上传文件接口返回的FileId（上传文件接口的fileType：ID_FRONT_REAL_NAME
55.	代理人信息证件照反面	businessIdReverse	O	Number	上传文件接口返回的FileId（上传文件接口的fileType：ID_REVERSE_REAL_NAME）,证件类型为1时必填
56.	代理人信息证件号码	businessIdNo	O	String(18)
57.	代理人信息姓名	businessName	O	String(128)
58.	代理人信息出生日期	businessBirthDate	O	String(10)	格式 YYYY-MM-DD
59.	代理人信息证件有效期	businessIdExpiryDate	O	String(10)	格式 YYYY-MM-DD
60.	代理人信息企业授权书	businessPowerOfAttorney	O	Number	上传文件接口返回的FileId（上传文件接口的fileType：POWER_OF_ATTORNEY_REAL_NAME）
61.	代理人国籍	businessCountry	O	String(3)	国家3位编码

3-香港企业

受益人信息：支持多位，参数为数组，非必填数据可传null进行占位
证件到期：营业执照号不可更改，变更无效

序号	域名	变量名	必填	长度	备注
01.	商业登记证	businessRegister	M	Number	上传文件接口返回的FileId（上传文件接口的fileType：BUSINESS_REGISTER_REAL_NAME）
02.	周年申报表	declarationForm	O	Number	上传文件接口返回的FileId（上传文件接口的fileType：DECLARATION_FORM_REAL_NAME）,公司注册满一年需提供周年申报表
03.	法团成立表	incorporationForm	M	Number	上传文件接口返回的FileId（上传文件接口的fileType：INCORPORATION_FORM_REAL_NAME）
04.	注册证书	orgRegister	M	Number	上传文件接口返回的FileId（上传文件接口的fileType：ORG_REGISTER_REAL_NAME）
05.	股权架构	stockCertificate	O	Number	上传文件接口返回的FileId（上传文件接口的fileType：STOCK_CERTIFICATE_REAL_NAME）
06.	企业名称	name	M	String(128)
07.	企业英文名称	enName	O	String(128)	仅支持填写数字英文字母,.()-‘单个空格,请将&符号用and替换
08.	注册证书编号	orgRegisterNo	M	String(32)
09.	商业登记号码	businessRegisterNo	M	String(32)
10.	商业登记证有效期	businessRegisterExpiryDate	M	String(10)	格式 YYYY-MM-DD
11.	成立日期	registerDate	M	String(10)	格式 YYYY-MM-DD
12.	注册资本(港元)	registerAmt	M	Number
13.	注册地址(省)	registerProvince	M	String(32)	格式必须是code_name 如：210000_辽宁省省市区编码详见附件
14.	注册地址(市)	registerCity	M	String(32)	格式必须是code_name 如：210200_大连市省市区编码详见附件
15.	注册地址(区)	registerArea	O	String(32)	格式必须是code_name 如：210202_中山区省市区编码详见附件
16.	注册地址(详细地址)	registerAddress	M	String(128)
17.	经营地址(省)	province	M	String(32)	格式必须是code_name 如：210000_辽宁省省市区编码详见附件
18.	经营地址(市)	city	M	String(32)	格式必须是code_name 如：210200_大连市省市区编码详见附件
19.	经营地址(区)	area	O	String(32)	格式必须是code_name 如：210202_中山区省市区编码详见附件
20.	经营地址(详细地址)	address	M	String(128)
21.	董事证件类型	directorIdType	M	Number	CHN(中国): 1-中国大陆二代身份证； HKG(中国香港): 2-护照/3-香港永久性居民身份证/4-香港居民身份证；其他国家传: 2-护照/5-公民身份证；注：会根据用户国籍验证对应类型，请按要求填写
22.	董事证件照正面	directorIdFront	M	Number	上传文件接口返回的FileId（上传文件接口的fileType：ID_FRONT_REAL_NAME）
23.	董事证件照反面	directorIdReverse	O	Number	上传文件接口返回的FileId（上传文件接口的fileType：ID_REVERSE_REAL_NAME）,证件类型为1时必填
24.	董事手持证件照	directorIdHold	M	Number	上传文件接口返回的FileId（上传文件接口的fileType：ID_HOLD_REAL_NAME）
25.	董事证件号	directorIdNo	M	String(18)
26.	董事姓名	directorName	M	String(128)	与法定代表人一致
27.	董事First Name	directorFirstName	M	String[]	不允许包含中文字符
28.	董事Last Name	directorLastName	M	String[]	不允许包含中文字符
29.	董事出生日期	directorBirthDate	M	String(10)	格式 YYYY-MM-DD
30.	董事证件有效期	directorCertExpiryDate	M	String(10)	格式 YYYY-MM-DD
31.	董事常住地址(省)	directorProvince	M	String(32)	格式必须是code_name 如：210000_辽宁省省市区编码详见附件
32.	董事常住地址(市)	directorCity	M	String(32)	格式必须是code_name 如：210200_大连市省市区编码详见附件
33.	董事常住地址(区)	directorArea	O	String(32)	格式必须是code_name 如：210202_中山区省市区编码详见附件
34.	董事常住地址(地址)	directorAddress	M	String(128)
35.	董事国籍	directorCountryCode	M	String(3)	国家3位编码
36.	受益人信息证件类型	beneficiaryIdType	M	Number[]	CHN(中国): 1-中国大陆二代身份证； HKG(中国香港): 2-护照/3-香港永久性居民身份证/4-香港居民身份证；其他国家传: 2-护照/5-公民身份证；注：会根据用户国籍验证对应类型，请按要求填写
37.	受益人信息证件照正面	beneficiaryIdFront	M	Number[]	上传文件接口返回的FileId（上传文件接口的fileType：ID_FRONT_REAL_NAME
38.	受益人信息证件照反面	beneficiaryIdReverse	M	Number[]	上传文件接口返回的FileId（上传文件接口的fileType：ID_REVERSE_REAL_NAME）,可传null进行占位,证件类型为1时必填
39.	受益人信息证件号码	beneficiaryIdNo	M	String[]
40.	受益人信息姓名	beneficiaryName	M	String[]
41.	受益人信息First Name	beneficiaryFirstName	M	String[]	不允许包含中文字符
42.	受益人信息Last Name	beneficiaryLastName	M	String[]	不允许包含中文字符
43.	受益人信息出生日期	beneficiaryBirthDate	M	String[]	格式 YYYY-MM-DD
44.	受益人信息证件有效期	beneficiaryCertExpiryDate	M	String[]	格式 YYYY-MM-DD
45.	受益人信息常住地址(省)	beneficiaryProvince	M	String[]	格式必须是code_name 如：210000_辽宁省省市区编码详见附件
46.	受益人信息常住地址(市)	beneficiaryCity	M	String[]	格式必须是code_name 如：210200_大连市省市区编码详见附件
47.	受益人信息常住地址(区)	beneficiaryArea	M	String[]	格式必须是code_name 如：210202_中山区省市区编码详见附件,可传null进行占位
48.	受益人信息常住地址(详细地址)	beneficiaryAddress	M	String[]
49.	受益人信息持股比率	beneficiaryShareholderRatio	M	Number[]	多位加起来不能超过100%
50.	受益人信息国籍	beneficiaryCountry	M	String[]	国家3位编码

5-其他地区企业

董事信息：支持多位，参数为数组，非必填数据可传null进行占位
受益人信息：支持多位，参数为数组，非必填数据可传null进行占位

序号	域名	变量名	必填	长度	备注
1.	注册证书	orgRegister	M	Number	上传文件接口返回的FileId（上传文件接口的fileType：ORG_REGISTER_REAL_NAME）
2.	其他附件	otherAccessories	M	Number	上传文件接口返回的FileId（上传文件接口的fileType：OTHER_ACCESSORIES_REAL_NAME）
3.	企业注册地	registerCountry	M	String(3)	国家3位编码
4.	企业名称	name	M	String(128)
5.	企业英文名称	enName	M	String(128)	仅支持填写数字英文字母,.()-‘单个空格,请将&符号用and替换
6.	注册证书编号	orgRegisterNo	M	String(32)
7.	成立日期	registerDate	M	String(10)	格式 YYYY-MM-DD
8.	注册资本	registerAmt	M	Number
9.	注册地址(省/州)	registerProvince	M	String(64)
10.	注册地址(城市)	registerCity	M	String(64)
11.	注册地址(详细地址)	registerAddress	M	String(128)
12.	经营地址(省/州)	province	M	String(64)
13.	经营地址(城市)	city	M	String(64)
14.	经营地址(详细地址)	address	M	String(128)
14.	邮编	postcode	o	String(6)
15.	董事国籍	directorCountryCode	M	String[]	国家3位编码
16.	董事证件类型	directorIdType	M	Number[]	CHN(中国): 1-中国大陆二代身份证； HKG(中国香港): 2-护照/3-香港永久性居民身份证/4-香港居民身份证；其他国家传: 2-护照/5-公民身份证；注：会根据用户国籍验证对应类型，请按要求填写
17.	董事证件照正面	directorIdFront	M	Number[]	上传文件接口返回的FileId（上传文件接口的fileType：ID_FRONT_REAL_NAME）
18.	董事证件照反面	directorIdReverse	O	Number[]	上传文件接口返回的FileId（上传文件接口的fileType：ID_REVERSE_REAL_NAME）,证件类型为1时必填
19.	董事手持证件照	directorIdHold	M	Number[]	上传文件接口返回的FileId（上传文件接口的fileType：ID_HOLD_REAL_NAME）
20.	董事证件号	directorIdNo	M	String[]
21.	董事姓名	directorName	M	String[]
22.	董事First Name	directorFirstName	M	String[]	不允许包含中文字符
23.	董事Last Name	directorLastName	M	String[]	不允许包含中文字符
24.	董事出生日期	directorBirthDate	M	String[]	格式 YYYY-MM-DD
25.	董事证件有效期	directorCertExpiryDate	M	String[]	格式 YYYY-MM-DD
26.	董事常住地址(省)	directorProvince	O	String[]	可传null进行占位
27.	董事常住地址(市)	directorCity	O	String[]	可传null进行占位
28.	董事常住地址(区)	directorArea	O	String[]	可传null进行占位
29.	董事常住地址(地址)	directorAddress	M	String[]
30.	受益人信息国籍	beneficiaryCountry	M	String[]	国家3位编码
31.	受益人信息证件类型	beneficiaryIdType	M	Number[]	CHN(中国): 1-中国大陆二代身份证； HKG(中国香港): 2-护照/3-香港永久性居民身份证/4-香港居民身份证；其他国家传: 2-护照/5-公民身份证；注：会根据用户国籍验证对应类型，请按要求填写
32.	受益人信息证件照正面	beneficiaryIdFront	M	Number[]	上传文件接口返回的FileId（上传文件接口的fileType：ID_FRONT_REAL_NAME
33.	受益人信息证件照反面	beneficiaryIdReverse	M	Number[]	上传文件接口返回的FileId（上传文件接口的fileType：ID_REVERSE_REAL_NAME）,可传null进行占位,证件类型为1时必填
34.	受益人信息证件号码	beneficiaryIdNo	M	String[]
35.	受益人信息姓名	beneficiaryName	M	String[]
36.	受益人信息First Name	beneficiaryFirstName	M	String[]	不允许包含中文字符
37.	受益人信息Last Name	beneficiaryLastName	M	String[]	不允许包含中文字符
38.	受益人信息出生日期	beneficiaryBirthDate	M	String[]	格式 YYYY-MM-DD
39.	受益人信息证件有效期	beneficiaryCertExpiryDate	M	String[]	格式 YYYY-MM-DD
40.	受益人信息常住地址(省)	beneficiaryProvince	O	String[]	可传null进行占位
41.	受益人信息常住地址(市)	beneficiaryCity	O	String[]	可传null进行占位
42.	受益人信息常住地址(区)	beneficiaryArea	O	String[]	可传null进行占位
43.	受益人信息常住地址(详细地址)	beneficiaryAddress	M	String[]
44.	受益人信息持股比率	beneficiaryShareholderRatio	M	Number[]	最低25% -最高100% 多位加起来不能超过100%

dataContent示例

{
  "callBackUrl": "",
  "information": {
    "address": "某个地方",
    "area": "210202_中山区",
    "beneficiaryAddress": [
      "一个村庄"
    ],
    "beneficiaryArea": [
      null
    ],
    "beneficiaryBirthDate": [
      "2000-01-01"
    ],
    "beneficiaryCertExpiryDate": [
      "9999-01-01"
    ],
    "beneficiaryCity": [
      "210200_大连市"
    ],
    "beneficiaryCountry": [
      "CHN"
    ],
    "beneficiaryIdFront": [
      13331435
    ],
    "beneficiaryIdNo": [
      "421000195710070000"
    ],
    "beneficiaryIdReverse": [
      13331436
    ],
    "beneficiaryIdType": [
      1
    ],
    "beneficiaryName": [
      "阿木木"
    ],
    "beneficiaryProvince": [
      "210000_辽宁省"
    ],
    "beneficiaryShareholderRatio": [
      100
    ],
    "city": "210200_大连市",
    "companyType": "有限责任公司",
    "economyId": "159",
    "enName": "QU QIU YOU XIAN HU LIAN",
    "endDate": "9999-01-01",
    "industryId": "0313",
    "legalAddress": "一个村庄",
    "legalArea": "210202_中山区",
    "legalBirthDate": "2000-01-01",
    "legalCertExpiryDate": "9999-01-01",
    "legalCity": "210200_大连市",
    "legalCountryCode": "CHN",
    "legalIdFront": 13331435,
    "legalIdHold": 13331436,
    "legalIdNo": "421000195710070000",
    "legalIdType": "2",
    "legalName": "阿木木",
    "legalProvince": "210000_辽宁省",
    "legalRepresentative": "阿木木",
    "license": 13331433,
    "licenseNo": "913101045680189600",
    "managementScope": "经营范围",
    "name": "全球有限互联公司",
    "province": "210000_辽宁省",
    "registerAddress": "某个地方",
    "registerAmt": "100",
    "registerArea": "210202_中山区",
    "registerCcy": "CNY",
    "registerCity": "210200_大连市",
    "registerDate": "2000-01-01",
    "registerProvince": "210000_辽宁省"
  },
  "userNo": "5181240322000274308",
  "userType": "2"
}

响应参数

👉说明：

响应参数详见：响应报文

结果信息result

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

result示例

true

作者：陈花枪创建时间：2024-08-15 10:54
最后编辑：陈花枪更新时间：2025-04-09 11:54