发起企业实名认证4要素校验
接口描述
- 进行企业四要素信息比对并创建认证流程,仅支持大陆法人注册的企业认证
接口地址
/v2/identity/auth/api/organization/enterprise/fourFactors
请求方式
- POST
- 请求报文体采用Json数据格式,编码方式采用UTF-8编码
请求参数
参数名 | 说明 | 参数类型 | 是否必填 | 类型 |
---|---|---|---|---|
name | 组织机构证件(如营业执照)上的组织机构名称 | body | 是 | string |
orgCode | 组织机构证件号,支持统一社会信用代码号和工商注册号(部分个体工商户) | body | 是 | string |
legalRepName | 法定代表人名称 | body | 是 | string |
legalRepIdNo | 法定代表人证件号 | body | 是 | string |
contextId | 对接方业务上下文id,将在异步通知及跳转时携带返回对接方 | body | 否 | string |
notifyUrl | 认证结束后异步通知地址,具体见"异步通知"章节说明 | body | 否 | string |
请求示例
POST /v2/identity/auth/api/organization/enterprise/fourFactors HTTP/1.1
{
"name":"杭州天谷信息科技有限公司",
"orgCode":"913301087458306077",
"legalRepName":"何一兵",
"legalRepIdNo":"110108xxxxxxx2xxx",
"repetition":true,
"contextId": "f0a7927d-c5f9-4652-a053-1130d86c8fa8",
"notifyUrl": "http://172.20.62.10:8080/testnotify/msgRecive"
}
响应参数
参数名 | 说明 | 类型 |
---|---|---|
code | int | 接口响应结果码 |
message | string | 接口响应结果描述 |
data | object | 接口响应结果数据 |
flowId | string | 实名流程Id |
响应示例
{
"code": 0,
"message": "成功”,
"data":{
"flowId": "836551334533533698"
}
}
错误码
错误码 | 错误信息 | 错误原因 |
---|---|---|
30500114 | 企业代表人身份证信息缺失 | 账号未设置legalIdNo属性 |