文档首页> 合作伙伴中心> API参考> 管理客户> 实名认证> 申请实名认证变更
更新时间：2022-12-16 GMT+08:00
查看PDF

申请实名认证变更

功能介绍

客户可以进行实名认证变更申请。

个人客户登录帐号中心通过实名认证变更为企业帐号的方式及流程请参见这里。

接口约束

  • 接口只允许使用合作伙伴账号AK/SK或者Token调用。
  • 伙伴必须在伙伴中心的“权益与支持 > 能力开放 > 接入配置”页面中开启“实名认证附件上传”后，才能调用该接口。
  • 实名认证的图片，必须上传到桶的download目录下面。
  • 通过调用接口的方式进行个人实名认证的变更目前仅支持个人转企业变更方式。

调试

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

URI

PUT /v2/customers/realname-auths/enterprise

请求消息

请求参数

参数

是否必选

参数类型

取值范围

描述

customer_id

是

String

最大长度：64

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

identify_type

是

Integer

-

认证方案：

1：单位证件扫描

verified_file_url

是

List<String>

最大长度：4

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

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

单位证件顺序为：

第1张单位证件照正面，

第2张单位证件照反面，

个人证件顺序为：

第1张个人证件的人像面

第2张个人证件的国徽面

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

abc023

def004

的顺序填写URL（文件名称区分大小写）

证件附件目前仅仅支持jpg、jpeg、bmp、png、gif、pdf格式，单个文件最大不超过10M。

这个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

单位证件号码。

change_type

是

Integer

[1]

变更类型：

1：个人变企业

xaccount_type

是

String

最大长度：64

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

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

certificate_type

否

Integer

-

单位证件类型。

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

此参数不携带或携带值为null时，不赋值。

reg_country

否

String

最大长度：10

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

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

此参数不携带或携带值为null时，不赋值；携带值为空串时，赋值空串。

reg_address

否

String

最大长度：256

实名认证企业注册地址。

此参数不携带或携带值为null时，不赋值；携带值为空串时，赋值空串。

enterprise_person

否

EnterprisePerson Object

-

单位人员信息，请参见表1。该字段预留。
表1 EnterprisePerson

参数

是否必选

参数类型

取值范围

描述

legel_name

是

String

最大长度：255

法人姓名。

legel_id_number

是

String

最大长度：32

法人身份证号。

certifier_role

否

String

最大长度：32

认证人角色。

legalPerson ：法人代表。

请求示例

PUT  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",
    "change_type":1
}

响应消息

响应参数

状态码：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

检查项名称

IS_DEBT

客户欠费。

IS_CREDIT_ACCOUNT

客户有信用账户且有信用欠款。

IS_ORG_ACCOUNT

客户账号是企业主账号或者企业子账号。

MEM_OF_ORG

您是同一法人关联类型的企业子账号，请解除与企业主账号绑定关系后再重新实名认证。

MEN_ANSWERING_ORG

您正在关联成为企业子账号，请拒绝后重新实名认证。

ORG_INVITING_MEM

您是企业主账号，正在邀请关联企业子账号，请取消邀请关联企业子账号后再重新实名认证。

ORG_HAVE_MEM_EQUITY_APPLYING

您是企业主账号，股权证明正在审核中，需要审核通过再重新实名认证。

MEM_OF_ORG_EQUITY_APPLYING

您是企业子账号，股权证明正在审核中，需要审核通过再重新实名认证。

ORG_HAVE_MEM_EQUITY_APPROVED

您是企业主账号，已存在股权证明，请解除存在股权证明的企业子账号后再重新实名认证。

MEM_OF_ORG_EQUITY_APPROVED

您是企业子账号，已存在股权证明，请解除与企业主账号的绑定关系后再重新实名认证。

响应示例

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.99007004

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

400

CBC.99007188

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

400

CBC.99007191

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

400

CBC.70600026

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

403

CBC.0151

访问拒绝。

500

CBC.0999

未知错误。
父主题： 实名认证