跳到主要内容

创建企业认证链接

1. 接口描述​

接口请求域名： ess.tencentcloudapi.com 。

本接口（CreateOrganizationAuthUrl）的主要功能是生成合作企业的认证链接。

在生成链接的过程中，可以提供一部分已知信息，以便为对方进行认证流程提供便利。

image

  • 企业统一社会信用代码: 对应上图中的1
  • 企业名称: 对应上图中的2
  • 企业法定代表人的名字:对应上图中的3
  • 企业详细住所:对应上图中的4
注：此接口需要 购买单独的实名套餐包方可调用，如有需求请联系对接人员评估

默认接口请求频率限制：20次/秒。

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数​

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。

参数名称必选类型描述
Action是String公共参数，本接口取值：CreateOrganizationAuthUrl。
Version是String公共参数，本接口取值：2020-11-11。
Region否String公共参数，此参数为可选参数。
Operator是UserInfo操作人信息
AuthorizationTypes.N否Array of Integer指定授权方式 支持多选:


  • 1:上传授权书方式
  • 2: 法人授权方式
  • 3: 法人身份认证方式


示例值：[2,3]
OrganizationName否String认证企业名称，请确认该名称与企业营业执照中注册的名称一致。

注：

1. 如果名称中包含英文括号()，请使用中文括号（）代替。

2. EndPointType=“H5”或者"SHORT_H5"时，该参数必填

示例值： 腾讯科技（深圳）有限公司
UniformSocialCreditCode否String企业统一社会信用代码
示例值：9144030071526726XG
LegalName否String企业法人的姓名
示例值：张三
AutoJumpUrl否String认证完成跳回的链接，最长500个字符
示例值：https://auth.qq.com/action-next?uid=12345
OrganizationAddress否String营业执照企业地址
示例值： 深圳市南山区高新区科技中一路腾讯大厦
AdminName否String认证人姓名
示例值：李四
AdminMobile否String认证人手机号
示例值：13200000000
AdminIdCardNumber否String认证人身份证号
示例值：620000198802020000
AdminIdCardType否String认证人证件类型， 支持以下类型
  • ID_CARD : 中国大陆居民身份证 (默认值)
  • HONGKONG_AND_MACAO : 中国港澳居民来往内地通行证
  • HONGKONG_MACAO_AND_TAIWAN : 中国港澳台居民居住证(格式同中国大陆居民身份证)


示例值：ID_CARD
UniformSocialCreditCodeSame否Boolean对方打开链接认证时，对方填写的营业执照的社会信用代码是否与接口上传上来的要保持一致。
  • false（默认值）：关闭状态，实际认证时允许与接口传递的信息存在不一致。
  • true：启用状态，实际认证时必须与接口传递的信息完全相符。

示例值：false
LegalNameSame否Boolean对方打开链接认证时，法人姓名是否要与接口传递上来的保持一致。
  • false（默认值）：关闭状态，实际认证时允许与接口传递的信息存在不一致。
  • true：启用状态，实际认证时必须与接口传递的信息完全相符。


p.s. 仅在法人姓名不为空时有效
示例值：false
AdminNameSame否Boolean对方打开链接认证时，认证人姓名是否要与接口传递上来的保持一致。
  • false（默认值）：关闭状态，实际认证时允许与接口传递的信息存在不一致。
  • true：启用状态，实际认证时必须与接口传递的信息完全相符。


p.s. 仅在认证人姓名不为空时有效
示例值：false
AdminIdCardNumberSame否Boolean对方打开链接认证时，认证人居民身份证件号是否要与接口传递上来的保持一致。
  • false（默认值）：关闭状态，实际认证时允许与接口传递的信息存在不一致。
  • true：启用状态，实际认证时必须与接口传递的信息完全相符。


p.s. 仅在认证人身份证号不为空时有效

示例值：false
AdminMobileSame否Boolean对方打开链接认证时，认证人手机号是否要与接口传递上来的保持一致。

  • false（默认值）：关闭状态，实际认证时允许与接口传递的信息存在不一致。
  • true：启用状态，实际认证时必须与接口传递的信息完全相符。



p.s. 仅在认证人手机号不为空时有效
示例值：false
OrganizationNameSame否Boolean对方打开链接认证时，企业名称是否要与接口传递上来的保持一致。
  • false（默认值）：关闭状态，实际认证时允许与接口传递的信息存在不一致。
  • true：启用状态，实际认证时必须与接口传递的信息完全相符。



p.s. 仅在企业名称不为空时有效
示例值：false
BusinessLicense否String营业执照正面照（支持PNG或JPG格式）需以base64格式提供，且文件大小不得超过5MB。
示例值：UEsDBBQACAAIAAAAAAAAAAAAAAAAAAAAAAANAAAAeGwvc3R5bGVzLnhtbKyYXW==
Endpoint否String跳转链接类型：


  • PC：适用于PC端的认证链接
  • APP：用于全屏或半屏跳转的小程序链接
  • SHORT_URL：跳转小程序的链接的短链形式
  • H5：适用于H5页面的认证链接
  • SHORT_H5：H5认证链接的短链形式



示例值：PC
Initialization.N否Array of Integer指定企业初始化引导，现在可以配置如下的选项：

1: 启用此选项后，在企业认证的最终步骤将添加创建印章的引导。如下图的位置
image
示例值：1
PowerOfAttorneys.N否Array of String授权书(PNG或JPG或PDF) base64格式, 大小不超过8M 。
授权书可以通过接口生成企业授权书 来获得。
p.s. 如果上传授权书 ，需遵循以下条件
1. 超管的信息（超管姓名，超管手机号）必须为必填参数。
2. 认证方式AuthorizationTypes必须只能是上传授权书方式
示例值：UEsDBBQACAAIAAAAAAAAAAAAAAAAAAAAAAANAAAAeGwvc3R5bGVzLnhtbKyYXW

3. 输出参数​

参数名称类型描述
AuthUrlString生成的认证链接。

注： 链接有效期统一30天
示例值：https://essurl.cn/24VopUGBZyF
ExpiredTimeInteger链接过期时间，格式为Unix标准时间戳（秒）
示例值：1733388643
RequestIdString唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。

4. 示例​

示例1 创建企业认证链接​

我们传递企业名称和企业的统一信用代码。同时，为了确保信息的准确性和合规性，我们要求在进行企业认证时，企业名称和统一信用代码必须与我们传递的信息完全一致。

输入示例​

POST / HTTP/1.1
Host: ess.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateOrganizationAuthUrl
<公共请求参数>

{
    "Operator": {
        "UserId": "yDwfsUUckpsqt647UE6uSrk1ZWhYH56z"
    },
    "Endpoint": "SHORT_URL",
    "AuthorizationTypes": [
        1,
        2,
        3
    ],
    "UniformSocialCreditCode": "9144030071526726XG",
    "OrganizationName": "典子谦示例企业",
    "UniformSocialCreditCodeSame": true,
    "OrganizationNameSame": true,
    "Initialization": [
        1
    ]
}

输出示例​

{
    "Response": {
        "AuthUrl": "https://essurl.cn/24VopUGBZyF",
        "ExpiredTime": 1733388643,
        "RequestId": "a34b6e8e-4a3e-444d-8853-b34f90096254"
    }
}

示例2 创建企业认证链接-通过授权书上传​

场景：创建企业认证链接， 通过超管授权书上传， 这个场景一般是法人不方便操作的时候使用 授权书的文件生成 可以通过接口生成企业授权书 然后转成 base64 格式。 但是必须得保证超管和创建企业认证是同一个人。

  1. AuthorizationTypes 必须且只能传递 1- 授权书认证。
  2. PowerOfAttorneys base64 格式的文件流 数组。 单个大小不能超过 8M。

输入示例​

POST / HTTP/1.1
Host: ess.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateOrganizationAuthUrl
<公共请求参数>

{
    "Operator": {
        "UserId": "yDwfsUUckpsqt647UE6uSrk1ZWhYH56z",
        "ClientIp": "8.8.8.8"
    },
    "Endpoint": "PC",
    "AuthorizationTypes": [
        1
    ],
    "AdminName": "典子谦",
    "AdminMobile": "13200000000",
    "BusinessLicense": "base64格式的营业执照文件流",
    "PowerOfAttorneys": [
        "base64格式的授权书文件流"
    ]
}

输出示例​

{
    "Response": {
        "AuthUrl": "https://test.qian.tencent.cn/console/register-callback?token=yDCYOUUckp7aat8yUxJf7vsvwREPT0Th",
        "ExpiredTime": 1743070967,
        "RequestId": "s1735294966632123121"
    }
}

5. 错误码​

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。

错误码描述
InternalError.System系统错误，请稍后重试。
InvalidParameter.AuthorizationType不合法的授权方式，请检查修改后重试。
InvalidParameter.EndPoint不合法的EndPoint，请检查修改后重试。
InvalidParameter.JumpUrl不合法的跳转链接，请联系电子签客服添加链接白名单。
MissingParameter.OrganizationId缺少机构ID参数。
OperationDenied.WhiteListForbid未开通功能白名单，请联系客服处理。
更多开发者交流反馈
购买咨询
联系销售
预约咨询
购买热线
售后反馈