【3要素】企业核身认证

更新时间:2025-09-15 16:10:17

接口描述

进行企业三要素信息比对并创建认证流程

【注】核身认证无需提前为用户创建账号;

接口

/v2/identity/auth/api/organization/threeFactors

请求方式

POST

请求头

提供两种安全接入方式,对应参数如何获取,参考文档【请点击】。

请求参数

参数名称

类型

必选

参数位置

参数说明

name

string

body

组织机构证件(如营业执照)上的组织机构名称

orgCode

string

body

组织机构证件号

支持统一社会信用代码号和工商注册号(部分个体工商户)

legalRepName

string

body

法定代表人名称

contextId

string

body

自定义业务标识,,将在异步通知及跳转时携带返回对接方

notifyUrl

string

body

认证结束后异步通知地址,具体见 异步通知 章节说明

响应参数

展开全部参数参数名称(点击左侧“+”一键展开)

类型

必选

参数说明

code

int32

业务码,0表示成功,非0表示异常。

message

string

错误信息

请根据 code 来判断错误情况,不应该依赖message匹配,因为 message 可能会调整。

data

object

业务信息

flowId

string

认证流程ID

请求示例  

{
    "name":"杭州xx信息科技有限公司",
    "orgCode":"9133010xxxx8306077",
    "legalRepName":"何xx",
    "contextId":"xxxxx",
    "notifyUrl":"http://172.xx.xx.10:8080/notify/msgRecive"
}

响应示例

{
    "code": 0,   
    "message": "成功”,
    "data":{
        "flowId": "793892****6108606"
    }
  }

错误码

错误码

错误描述

解决方案

1100007

企业信息不匹配

请核实企业信息的真实性

1203052

核验信息不存在

请核实企业信息的真实性

30500000

操作出错,请联系服务人员处理, ID:XXXX

请核实入参格式是否正确

30500001

认证失败:企业信息校验未通过

请核实企业信息的真实性

30500100

缺少参数:XXXX

请核实创建企业账号时,是否传入对应的参数信息

30500101

参数错误:XXXX

请核实企业信息是否传入正确

30500116

格式校验不通过,请检查填入信息是否有多余空格

请核实入参是否存在空格

30503107

很抱歉,订单余额不足

请核实是否有购买认证服务套餐,或登录e签宝官网核实账单记录

30504001

信息比对不通过,请检查信息的正确性

请核实企业信息的真实性

30504002

数据源查询失败,请联系服务人员处理,ID:XXXX

数据源查询无此企业信息,请联系e签宝相关工作人员处理


我要纠错