获取企业认证&授权链接

用于获取企业的认证授权页面链接，通过此链接企业用户可进行个人实名认证、资源授权等操作。

注意

用户授权有效期默认永久有效（100年）。
新注册企业需要等工商信息更新后（预计1周）方可使用，

可以调用【查询企业授权信息】获取企业授权有效期和授权范围

可以调用【查询企业认证信息】查询企业的认证状态和个人openCorpId

企业认证方式2种（corpIdentMethod）

legalRep - 法人认证：营业执照+法人人脸OCR

agent - 授权人（经办人）认证：营业执照+企业银行打款+经办人授权书

设置页面中可选择的个人授权范围

get_corp_ident_info - 授权允许获取企业身份信息

get_corp_seal_info - 授权允许获取企业的印章相关资源

get_corp_organization - 授权允许获取企业的组织数据

get_corp_template - 授权允许获取企业的模板数据

corp_sign_task_init - 授权允许代表企业发起合同

get_corp_sign_task_info - 授权允许获取企业的合同信息

get_corp_sign_task_file - 授权允许获取企业的合同文件

请求头格式

具体请求头参数，请查看公共请求格式

请求参数

Body 参数application/json

corpAuthConfig

object

企业信息

必需

组织机构认证配置项

openCorpId

string | null

企业ID

可选

企业应用帐号ID 与 corpName 必选一项

corpName

string | null

企业名

可选

组织机构名称（企业名称）与openCorpId 必选一项

corpIDCardType

string

企业证件类型

必需

默认企业证件类型（固定值）CRED_ORG_USCC - 统一社会信用

corpIDCardNum

string | null

企业证件号

可选

默认企业证件号（选填）与企业证件类型配合使用，可在pageConfig.corpEditableFields限制用户修改

legalRepName

string | null

法人姓名

可选

默认法人姓名（选填），可在pageConfig.corpEditableFields限制用户修改

transactorInfo

object

操作人

必需

corpIdentMethod

string | null

企业认证方式

可选

V1.6.0新增
legalRep限制法人认证（营业执照+法人OCR）
agent限制为授权人认证（营业执照+银行打款+授权书）
不传不限制。

pageConfig

object | null

页面配置项

可选

V1.6.0新增

corpEditableFields

array[string] | null

企业不可修改项

可选

企业不可修改项（默认可修改），可选项：
corpName：企业名称
corpIDCardNum：企业证件号
legalRepName：法人姓名

transactorEditableFields

array[string] | null

经办人不可修改项

可选

经办人不可修改项（默认可修改），可选项：
psnName：经办人名称
psnIDCardNum：经办人身份证号
psnMobile:认证手机号
psnAuthModes:企业经办人/法人认证方式

authorizeConfig

object

授权范围

必需

个人授权配置项，授权过期需重新授权

authorizedScopes

array[string]

范围数组

必需

设置页面中权限范围
get_corp_ident_info - 授权允许获取企业身份信息
get_corp_seal_info - 授权允许获取企业的印章相关资源
get_corp_organization - 授权允许获取企业的组织数据
get_corp_template - 授权允许获取企业的模板数据
corp_sign_task_init - 授权允许代表企业发起合同
get_corp_sign_task_info - 授权允许获取企业的合同信息
get_corp_sign_task_file - 授权允许获取企业的合同文件

redirectConfig

object | null

重定向配置

可选

认证完成重定向配置项

redirectUrl

string | null

可选

认证完成后跳转页面（需符合 https /http 协议地址）

redirectDelayTime

integer | null

可选

重定向跳转延迟时间，单位为秒。实名模式下（authorizedScopes不传或者没有具体的参数值）：默认延迟时间为 5秒。传 0 - 不展示实名结果页，认证完成直接跳转重定向地址传其他数字 - 展示实名结果页，倒计时5秒后，自动跳转重定向地址（只有5秒，没有其他秒数的控制）【注】当redirectUrl不传的情况下，该字段无需传入，认证完成结果页不跳转。

clientType

string

必需

指定客户端类型，
h5-移动端适配
pc-PC端适配

accountId

string

集成方唯一标识

可选

V2.2新增集成方唯一标识，同一应用不可重复

<= 64 字符

示例

{
  "corpAuthConfig": {
    "openCorpId": null,
    "corpName": "赋能通（浙江）科技有限公司",
    "corpIDCardType": "CRED_ORG_USCC",
    "corpIDCardNum": "91330109MA2H2CM85U",
    "legalRepName": "李志东",
    "transactorInfo": {
      "psnAccount": "135XXXXXXXX",
      "psnName": "李志东",
      "psnIDCardType": "CRED_PSN_CH_IDCARD",
      "psnIDCardNum": "330325XXXXXXXXXXXX",
      "psnMobile": "135XXXXXXXX",
      "psnAuthModes": "mobile"
    }
  },
  "corpIdentMethod": "legalRep",
  "pageConfig": {
    "corpEditableFields": [
      "corpName",
      "legalRepName"
    ],
    "transactorEditableFields": [
      "psnName",
      "psnIDCardNum"
    ]
  },
  "authorizeConfig": {
    "authorizedScopes": [
      "get_corp_sign_task_info"
    ]
  },
  "redirectConfig": {
    "redirectUrl": "http://ivd.vg/shgbx",
    "redirectDelayTime": 3
  },
  "clientType": "pc"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

string

业务码

必需

msg

string

业务信息

必需

result

object

业务数据

必需

authUrl

string

必需

机构认证授权长链接（有效期30天）

authFlowId

string

必需

本次认证授权流程ID

authCode

string

授权码

必需

accountId

string

集成方唯一标识

可选

success

boolean

是否成功

必需

string

时间戳

必需

logKey

string

日志key

必需

示例

{
  "result": {
    "authUrl": "https://saas-pc.pre-qiandun365.com/third/authorization?code=8ktuy2zht1pgqw6y3toj&appId=90",
    "authFlowId": "100003438",
    "authCode": "8ktuy2zht1pgqw6y3toj"
  },
  "code": "200",
  "msg": "成功",
  "logKey": "95f19937",
  "ts": "1711425120623",
  "success": true
}

企业认证方式2种（corpIdentMethod）#

设置页面中可选择的个人授权范围#

请求头格式#

请求参数

示例代码

返回响应

企业认证方式2种（corpIdentMethod）

设置页面中可选择的个人授权范围

请求头格式