文档首页/合作伙伴中心/API参考/管理客户/实名认证/申请企业实名认证-CreateEnterpriseRealnameAuthentication
更新时间：2025-12-09 GMT+08:00
查看PDF
分享

申请企业实名认证-CreateEnterpriseRealnameAuthentication

功能介绍

企业客户可以进行企业实名认证申请。

客户登录账号中心进行企业实名认证的方式及流程请参见这里。

接口约束

  • 该接口只允许使用解决方案提供商或华为云总经销商（一级经销商）的AK/SK或者Token调用。
  • 伙伴必须在伙伴中心的“权益与支持 > 能力开放 > 接入配置”页面中开启“实名认证附件上传”后，才能调用该接口。
  • 实名认证的图片，必须上传到桶的download目录下面。
  • 通过调用接口的方式进行企业实名认证目前仅支持单位证件认证方式。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

接口对应的权限项如下：

权限项

权限项名称

BPC_ITEM_SUBCUSTSERV_010119

销售-客户-客户管理-客户列表-实名认证同步（能力开放）

URI

POST /v2/customers/realname-auths/enterprise

请求消息

请求参数

参数

是否必选

参数类型

取值范围

描述

customer_id

是

String

最大长度：64

客户账号ID。您可以调用查询客户列表-ListSubCustomers接口获取customer_id。

identify_type

是

Integer

-

认证方案。

1：单位证件认证

verified_file_url

是

List<String>

最大长度：4

  1. 单位证件认证时证件附件的文件URL。

    附件地址必须按照顺序填写，先填写单位证件的附件，如果请求中填写了单位人员信息，再填写单位人员的身份证附件。

    单位证件顺序为：

    第1张单位证件照正面，

    第2张单位证件照反面，

    个人证件顺序为：

    第1张个人证件的人像面

    第2张个人证件的国徽面

    假设不存在法人的情况下，第1张上传的是单位证件正面扫描件abc.023，第2张上传的是单位证件反面扫描件def004，那么上传顺序需要是：

    abc023

    def004

    文件名称区分大小写。

  2. 证件附件目前仅仅支持jpg、jpeg、bmp、png、gif、pdf格式，单个文件最大不超过10M。
  3. 这个URL是相对URL，不需要包含桶名和download目录，只要包含download目录下的子目录和对应文件名称即可。举例如下：
    • 如果上传的证件附件在桶中的位置是：

      https://bucketname.obs.Endpoint.myhuaweicloud.com/download/abc023.jpg，该字段填写abc023.jpg；

    • 如果上传的证件附件在桶中的位置是：

      https://bucketname.obs.Endpoint.myhuaweicloud.com/download/test/abc023.jpg，该字段填写test/abc023.jpg。

corp_name

是

String

最大长度：255

单位名称。

不能全是数字、特殊字符、空格。

verified_number

是

String

最大长度：32

单位证件号码。

xaccount_type

是

String

最大长度：64

华为分给合作伙伴的平台标识。

该标识的具体值由华为分配。获取方法请参见如何获取xaccountType的取值。

certificate_type

否

Integer

-

单位证件类型：

  • 0：企业营业执照
  • 1：事业单位法人证书
  • 2：社会团体法人登记证书
  • 3：行政执法主体资格证
  • 4：组织机构代码证
  • 99：其他

reg_country

否

String

最大长度：10

实名认证填写的注册国家。国家的两位字母简码。

例如：注册国家为“中国”请填写“CN”。

reg_address

否

String

最大长度：256

实名认证企业注册地址。

enterprise_person

否

EnterprisePerson Object

-

单位人员信息，请参见表1。

表1 EnterprisePerson

参数

是否必选

参数类型

取值范围

描述

legel_name

是

String

最大长度：255

法人姓名。

legel_id_number

是

String

最大长度：32

法人身份证号。

certifier_role

否

String

最大长度：32

认证人角色。

legalPerson ：法人代表。

请求示例

POST  https://bss-intl.myhuaweicloud.com/v2/customers/realname-auths/enterprise HTTP/1.1
Content-Type: application/json
X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
{
    "verified_number": "371812********8888",
    "verified_file_url": [
        "gerenshiming/zhengmian001.jpg",
        "gerenshiming/fanmian002.jpg",
        "gerenshiming/chizheng003.jpg"
    ],
    "reg_address": "北京",
    "reg_country": "CN",
    "customer_id": "4505ce********de8263e33b57e76abc",
    "certificate_type": 0,
    "corp_name": "test001",
    "enterprise_person": {
        "certifier_role": "legalPerson",
        "legel_name": "wangmoumou",
        "legel_id_number": "371812********8888"
    },
    "identify_type": 1,
    "xaccount_type": "***_IDP"
}

响应消息

响应参数

状态码：200

参数

参数类型

取值范围

描述

is_review

Integer

-

是否需要转人工审核，只有状态码为200才返回该参数。

  • 0：不需要
  • 1：需要

状态码：400

参数

参数类型

取值范围

描述

error_code

String

最大长度：16

状态码。具体请参考状态码。只有失败才会返回这个参数。

error_msg

String

最大长度：1024

错误描述信息。只有失败才会返回这个参数。

is_review

Integer

-

是否需要转人工审核，只有状态码为200才返回该参数。

  • 0：不需要
  • 1：需要

fail_check_items

List<String>

-

错误列表，只有CBC.99007004才出现。请参见表2。

表2 failCheckItems列表

检查项ID

检查项名称

响应示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time  
{
  "is_review": "1"
}

状态码

  • 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。
  • 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。

HTTP状态码

错误码

错误描述

400

CBC.0100

参数错误。

400

CBC.99000035

非合作伙伴子客户。

400

CBC.99000099

客户实名认证时证件附件的文件大小超过最大配置值。

400

CBC.99000100

客户实名认证时证件附件的文件格式不正确。

400

CBC.99005030

伙伴未开通实名认证功能或者桶鉴权失败。

开启实名认证附件上传配置请参见这里。

400

CBC.99007004

发起的业务操作存在不满足的业务检查项。

400

CBC.99007188

该客户已经实名认证或者实名认证在审核中。

400

CBC.99007191

客户实名认证次数超过最大配置值。

400

CBC.70600026

抱歉，华为云暂无法审核您提交的实名认证信息，请联系您的客户经理协助。

400

CBC.70600032

操作失败，身份信息异常，存在违规风险，如有疑问请提工单咨询客服。

403

CBC.0151

访问拒绝。

500

CBC.0999

未知错误。

父主题：实名认证