发起组织机构实名认证3要素检验
接口描述
- 进行组织机构三要素信息比对并创建实名流程
接口地址
/v2/identity/auth/api/organization/{accountId}/threeFactors
请求方式
- POST
- 请求报文体采用Json数据格式,编码方式采用UTF-8编码
请求参数
参数名 | 说明 | 参数类型 | 必选 | 类型 |
---|---|---|---|---|
accountId | 待认证e签宝企业账号Id 账号创建详见 创建e签宝组织账号(电子签名场景专用)) |
path | 是 | string |
agentAccountId | 代理人账号Id,要求经办人证账号id已完成个人实名认证 经办人账号创建详见:创建e签宝个人账号(电子签名场景专用) 个人实名请详见5.1章节相关内容 |
body | 是 | string |
repetition | 是否允许账号重复实名(默认允许重复实名 | body | 否 | boolean |
contextId | 对接方业务上下文id,将在异步通知及跳转时携带返回对接方 | body | 否 | string |
notifyUrl | 认证结束后异步通知地址,具体见"异步通知"章节说明 | body | 否 | string |
请求示例
POST /v2/identity/auth/api/organization/{accountId}/threeFactors HTTP/1.1
{
"agentAccountId":"",
"repetition":true,
"contextId":"",
"notifyUrl":""
}
响应参数
参数名 | 说明 | 类型 |
---|---|---|
code | int | 接口响应结果码 |
message | string | 接口响应结果描述 |
data | object | 接口响应结果数据 |
flowId | string | 实名流程Id |
响应示例
{
"code": 0,
"message": "成功”,
"data":{
"flowId": "793892446156108606"
}
}
错误码
错误码 | 错误信息 | 错误原因 |
---|---|---|
30500001 | 认证流程不存在 | flowId在e签宝系统中不存在,检查flowId是否正确设置 |
30500100 | 缺少参数:法定代表人姓名 | 企业账号中未设置法定代表人姓名属性 |
30500156 | 账号不存在,请检查accountId的正确性 | 检查组织和代理人账号Id的是否正确传递参数 |
30502005 | 账号未设置有效的证件信息 | 账号中的codeReg和codeUsc字段同时未设置 |
30502008 | 经办人账号未实名,请先完成个人实名认证 | 组织认证流程中经办人未完成实名认证 |