企业实名认证上传
接口说明
[!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 | ? | 公章签章图片(规格:180*180PX,透明背景,.png格式),不传入可由系统生成,图片,不能超2MB | |
address | string | ? | 法人住址 | |
authorizeName | string | ? | 授权人姓名;如果在后面企业签约中需要对被授权人做认证(人脸识别,运营商三要素,银行卡认证等等)时,则必传 | |
authorizeCard | string | ? | 授权人身份证;如果在后面企业签约中需要对被授权人做认证(人脸识别,运营商三要素,银行卡认证等等)时,则必传 | |
authorizeMobilePhone | string | ? | 授权人手机号;如果在后面企业签约中需要对被授权人做认证(运营商三要素,银行卡认证,短信验证认证等等)时,则必传 | |
organizationCode | string | ? | 组织结构代码,多证时必传 | |
organizationCodeImg | file | ? | 组织结构代码扫描件,多证时必传,图片,不能超2MB,接口不对传入的组织机构代码扫描件进行真实性校验,需要开发者确保真实性。 | |
taxCertificateImg | file | ? | 税务登记扫描件,事业单位选填,其它多证时必传,图片,不能超2M,接口不对传入的税务登记扫描件做真实性校验,需要开发者确保真实性。 | |
signApplication | file | ? | 签约申请书(授权书)扫描图片,不能超2MB,接口不对传入的申请表(授权书)做真实性校验,需要发开发者确保真实性。君子签有提供模板,需要模板者可以联系君子签客服获取。 | |
notifyUrl | string | ? | 企业认证结果异步通知地址 |
代码实现
JAVA实现
Map<String, Object> params = bodyParams;
String url = SERVICE_URL + "/v2/user/organizationCreate";
params.put("emailOrMobile", "1yX7u8@yunDa.signCenter.com"); //邮箱
params.put("name", "广东XXXX有限公司"); //企业名称
params.put("organizationType", "1"); //企业类型
params.put("identificationType", "1"); //证件类型
params.put("organizationRegNo", "500XXXXXXX447"); //营业执照号
params.put("organizationRegImg",new File("d:\\唐\\timg.jpg"));//营业执照图片
params.put("legalName", "林XX");//法人姓名
params.put("legalIdentityCard", "50022XXXXXX28");//法人身份证号
params.put("legalMobile", "1862XXXXX71");//法人手机号
String str = HttpClientUtils.init().getPost(url, null, params, true);
System.out.println(str);
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}