数字证书申请认证（即SaaS API 2.0）

服务说明

[!NOTE]
获取企业或个人数字证书申请认证链接，支持PC端和移动端。

注：需要联系商务购买验证套餐（人脸识别、运营商三要素，银行卡四要素，短信验证码、企业营业执照OCR识别、个人身份证照片OCR识别），根据实际业务需求自选认证方式。

http请求方式

[!NOTE]
POST multipart/form-data

http请求地址

[!NOTE]
$SERVICE_URL/v2/sign/saas/advancedAuth/link #其中$SERVICE_URL为生产或测试的地址

http请求参数

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

参数	类型	是否必填	默认值	说明
mobileOrEmail	string	*		邮箱或手机号；手机号属于个人认证，邮箱属于企业认证。
name	string	?		用户名称
identityCard	string	?		证件号；个人传身份证号，企业传营业执照号/统一社会信用代码号
legalName	string	?		法人名称，企业时需传
backUrl	string	?		认证后或授权后跳转链接(需携带协议头如https或http 否则转跳会失败)
authType	int	*		用户认证类型（个人）；0：全部认证方式都可选（用户自行选择认证方式，三选一认证）；1：指定人脸识别；2：指定银行卡四要素验证；3：指定运营商三要素验证。用户认证类型（企业）；0：全部验证方式都可选（linkType=0时，支持上传授权书认证）------企业自行选择认证认证方式，三选一认证;1：指定短信邀请法定代表人做人脸验证；2:指定法定代表人银行卡四要素验证
linkType	int	*		链接类型 0：仅认证（通过合规的认证流程认证并申请数字证书）； 1：认证及授权（通过合规认证流程认证，通过认证后，用户实时给对接平台授权，仅针对实时返回认证结果的场景）；2：仅授权：用户之前未给对接平台授权，可支持补充授权
grantorAuthType	string	?	1	授权类型,1：邮件验证码；2：法人人脸识别；3：通知法定代表人完成授权；如要展示多种授权类型，需用逗号分开，如：1,2,3 ；默认使用1邮箱验证码。（注：仅 linkType=2时，该参数生效）
legalIdentityCard	string	+		法人身份证号码（注：grantorAuthType为2或者3时，法人身份证必传）
organizationRegImg	file	?		企业营业执照图片
identityFrontImg	file	?		身份证人像面
identityBackImg	file	?		身份证国徽面
useCustomDomain	int	?		固定值：1，使用自定义域名，默认：不使用；（注：嵌入小程序必设置该参数）
notifyUrl	string	?		自定义异步回调通知地址
notifySubject	string	?		通知主体手机号或邮箱（用于给企业发送实名认证的短信通知）

代码实现

JAVA实现

        Map<String, Object> params = bodyParams;
        String url = SERVICE_URL + "/v2/sign/saas/advancedAuth/link";
        params.put("mobileOrEmail", "ee1@bccto.me");  //机号或邮箱,手机号属于个人注册，邮箱属于企业注册
        params.put("name", "0");  //用户名称
        params.put("identityCard", "0");   //证件号(企业传统一社会信用代码，个人传身份证号)
        params.put("legalName", "0"); // 法人姓名
        params.put("backUrl", "https://xxxxxx");   //认证后或授权后跳转链接
        params.put("authType", "0");   //认证类型,0.全部验证方式;1:短信邀请、人脸,2:银行卡四要素,3:个人注册、注册且授权：运营商认证
        params.put("linkType", "0");   //链接类型,0:仅注册，1：注册授权，2：仅授权
       // params.put("organizationRegImg", new File("d:\\唐\\timg.jpg")); //组织注册证件扫描件，营业执照或事业单位法人证书
      /*  params.put("identityFrontImg", new File("d:\\唐\\委托签字.pdf"));  // 身份证正面文件
        params.put("identityBackImg", new File("d:\\唐\\委托签字.pdf"));  //身份证反面*/
        String str = HttpClientUtils.init().getPost(url, null, params, true);

http返回参数

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

参数	类型	是否必返回	说明
success	bool	*	成功true；异常false
msg	string	?	异常时，返回异常原因
resultCode	string	*	异常时返回
data	string	?	用户认证链接（支持h5和pc，有效期7天）注：需要联系商务购买验证套餐（人脸识别、运营商三要素，银行卡四要素，短信验证码、企业营业执照OCR识别、个人身份证照片OCR识别），根据实际业务需求自选认证方式。

data参数说明

参数	类型	是否必返回	说明
saasLink	string	*	认证页面长链接
saasShortLink	string	*	认证页面短连接

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

//正确响应：
{"data":{"saasLink":"https://accoCXXXXXX..........","saasShortLink":"https://XXXXXX"},"success":true}
//错误响应：
{"msg":"邮箱或手机信息不能为空","resultCode":"HTTP_PARAM_ERROR","success":false}

results matching ""

No results matching ""