新增实名信息

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

请求URL

POST {域名}/api/agent/user/certification-add

请求参数

👉说明：

请求参数详见 请求报文

加密数据dataContent

序号	域名	变量名	必填	长度	备注
01.	用户编号	userNo	M	Number	GEP提供给用户的唯一编号
02.	用户类型	userType	M	Number	1-境内个人 2-境内企业 3-香港企业 5-其他地区企业
03.	实名信息	information	M	Object	根据不同用户类型传入不同对象数据，具体参数如下
04.	回调地址	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 (长期传9999-01-01)
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	beneficiaryLastName	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[]	最低25%-最高100%,多位加起来不能超过100%
52.	受益人信息国籍	beneficiaryCountry	M	String[]	国家3位编码
53.	代理人信息证件类型	businessIdType	O	Number	CHN(中国): 1-中国大陆二代身份证； HKG(中国香港): 2-护照/3-香港永久性居民身份证/4-香港居民身份证；其他国家传: 2-护照/5-公民身份证；注：会根据用户国籍验证对应类型，请按要求填写
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	M	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	M	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)
15.	注册地址(区)	registerArea	O	String(32)	格式必须是code_name 如：210202_中山区省市区编码详见附件
16.	注册地址(详细地址)	registerAddress	M	String(128)	格式必须是code_name 如：210200_大连市省市区编码详见附件
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[]
26.	董事姓名	directorName	M	String[]
27.	董事First Name	directorFirstName	M	String[]	不允许包含中文字符
28.	董事Last Name	directorLastName	M	String[]	不允许包含中文字符
29.	董事出生日期	directorBirthDate	M	String[]	格式 YYYY-MM-DD
30.	董事证件有效期	directorCertExpiryDate	M	String[]	格式 YYYY-MM-DD
31.	董事常住地址(省)	directorProvince	M	String[]	格式必须是code_name 如：210000_辽宁省省市区编码详见附件
32.	董事常住地址(市)	directorCity	M	String[]	格式必须是code_name 如：210200_大连市省市区编码详见附件
33.	董事常住地址(区)	directorArea	O	String[]	格式必须是code_name 如：210202_中山区省市区编码详见附件
34.	董事常住地址(地址)	directorAddress	M	String[]
35.	董事国籍	directorCountryCode	M	String[]	国家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[]	最低25% -最高100%,多位加起来不能超过100%
50.	受益人信息国籍	beneficiaryCountry	M	String[]	国家3位编码

5-其他地区企业

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

序号	域名	变量名	必填	长度	备注
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.	经营地址(省/州)	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": "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

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