企业实名认证上传

接口说明

[!NOTE]
参与签约的企业用户，需事先通过实名认证。该接口提供企业基本工商三要素认证能力，认证通过后，才能对企业发起合同签署；有涉及到签约的企业用户此接口必调。

1、接口不对传入数据的来源核实，需要开发者确保传入数据的合法性、准确及真实性。

2、接口只对企业工商基本三要素（企业名称+营业执照号+法人姓名）做异步校验，不对企业真实意愿（法人/授权人人脸）做校验，需要开发者保证企业使用电子签章的真实意愿，开发者可以调用君子签提供的个人验证服务来确保企业真实意愿。

http请求方式

[!NOTE]
POST multipart/form-data

http请求地址

[!NOTE]
$SERVICE_URL/v2/user/organizationCreate #其中$SERVICE_URL为生产或测试的地址

http请求参数

[!NOTE]
除公共必填参数外，还需要传以下参数

参数	类型	是否必填	默认值	说明
emailOrMobile	string	?		邮箱(不填入时系统生成)，需要保证邮箱的唯一性，接口不对邮箱真实性做校验，符合邮箱规则即可
name	string	*		公司名称（注：企业名称如含括号请传中文的括号）
organizationType	int	*		组织类型 0企业,1事业单位
identificationType	int	*		证件类型：0多证,1多证合一
organizationRegNo	string	*		营业执照号或事业单位事证号或统一社会信用代码
organizationRegImg	file	*		营业执照号扫描件,图片,不能超2MB,接口不对传入的营业执照复印件图片进行真实性校验，需要开发者确保营业执照复印件的真实性。
legalName	string	*		法人姓名
legalIdentityCard	string	?		法人身份证号；如果在后面企业签约中需要对法人做认证（人脸识别，运营商三要素，银行卡认证等等）时，则必传
legalMobile	string	?		法人电话号码；如果在后面企业签约中需要对法人做认证（运营商三要素，银行卡认证，短信验证认证等等）时，则必传
legalIdentityFrontImg	file	?		法人身份证正面,图片,不能超2MB，接口不对传入的法人身份证照进行真实性校验，需要开发者确保真实性
legalIdentityBackImg	file	?		法人身份证反面,图片,不能超2MB，接口不对传入的法人身份证照进行真实性校验，需要开发者确保真实性
signImg	file	?		公章签章图片(规格：180180PX，透明背景，.png格式),不传入可由系统生成,图片*,不能超2MB
address	string	?		法人住址
authorizeName	string	?		授权人姓名；如果在后面企业签约中需要对被授权人做认证（人脸识别，运营商三要素，银行卡认证等等）时，则必传
authorizeCard	string	?		授权人身份证；如果在后面企业签约中需要对被授权人做认证（人脸识别，运营商三要素，银行卡认证等等）时，则必传
authorizeMobilePhone	string	?		授权人手机号；如果在后面企业签约中需要对被授权人做认证（运营商三要素，银行卡认证，短信验证认证等等）时，则必传
organizationCode	string	?		组织结构代码,多证时必传
organizationCodeImg	file	?		组织结构代码扫描件,多证时必传,图片,不能超2MB,接口不对传入的组织机构代码扫描件进行真实性校验，需要开发者确保真实性。
taxCertificateImg	file	?		税务登记扫描件,事业单位选填,其它多证时必传,图片,不能超2M，接口不对传入的税务登记扫描件做真实性校验，需要开发者确保真实性。
signApplication	file	?		签约申请书（授权书）扫描图片,不能超2MB，接口不对传入的申请表（授权书）做真实性校验，需要发开发者确保真实性。君子签有提供模板，需要模板者可以联系君子签客服获取。
notifyUrl	string	?		企业认证结果异步通知地址

代码实现

JAVA实现

//import org.apache.http.entity.mime.content.ByteArrayBody;
//import org.apache.http.entity.mime.content.FileBody;

RequestUtils requestUtils=RequestUtils.init(SERVICE_URL,APP_KEY,APP_SECRET);//建议生成为spring bean
//构建请求参数
OrganizationCreateReq req=new OrganizationCreateReq();
req.setName("XXXXXXXXXX发有限责任公司");
req.setIdentificationType(1);
req.setOrganizationType(0);
req.setOrganizationCode("91620XXXXXXXXX5XG");
req.setOrganizationRegImg(new ByteArrayBody(Files.readAllBytes(new File("/tmp/test.png").toPath()),"test.png"));
req.setLegalName("易XX");
req.setLegalIdentityCard("5002401XXXXXXXXX");//法人证件号
req.setLegalMobile("153XXXXXXXX");
//req.setSignImg(new ByteArrayBody(Files.readAllBytes(new File("/tmp/test.png").toPath()),"test.png"));
ResultInfot<String> ri= requestUtils.doPost("/v2/user/organizationCreate",req);

PHP实现

//构建请求工具
$requestUtils=new RequestUtils($serviceUrl, $appkey, $appSecret);
//CURLFile 可以传url或filePath，但必须保证文件存在且有效，否则php不会报错，只会导致http请求返回null（并没有调到服务端）。
//初始化合同参数
$request=new OrganizationCreateReq();
$request->name="XXXXXXXXXX发有限责任公司";
$request->identificationType=1;
$request->organizationType=0;
$request->organizationRegNo="91620XXXXXXXXX5XG";
$request->organizationRegImg= new CURLFile('D:/tmp/test.png',null,"test.png");
$request->legalName="易XX";//法人
$request->legalIdentityCard="5002401XXXXXXXXX";//法人证件号
$request->legalMobile="153XXXXXXXX";
//发起创建企业请求
$response=$requestUtils->doPost("/v2/user/organizationCreate",$request);

http返回参数

[!NOTE]
返回response为application/json的数据，其字段说明如下

参数	类型	是否必返回	说明
success	bool	*	成功true；异常false
msg	string	?	异常时，返回异常原因
resultCode	string	?	异常时返回
data	string	?	邮箱地址,成功时返回

[!NOTE]
返回结果，参考：

//正确响应：
{"data":"169338@ebq.org","success":true}
//错误响应：
{"msg":"organizationRegImg,不能为空","resultCode":"BUSINESS_ERROR","success":false}

results matching ""

No results matching ""