本文导读

展开导读

文档首页/ 合作伙伴中心/ API参考/ 管理客户/ 实名认证/ 申请实名认证变更

申请实名认证变更

更新时间：2025-02-28 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：需要

参数

参数类型

取值范围

描述

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.99000099	客户实名认证时证件附件的文件大小超过最大配置值。
400	CBC.99000100	客户实名认证时证件附件的文件格式不正确。
400	CBC.99007004	发起的业务操作存在不满足的业务检查项。
400	CBC.99007188	该客户已经实名认证或者实名认证在审核中。
400	CBC.99007191	客户实名认证次数超过最大配置值。
400	CBC.70600026	抱歉，华为云暂无法审核您提交的实名认证信息，请联系您的客户经理协助。
400	CBC.70600032	操作失败，身份信息异常，存在违规风险，如有疑问请提工单咨询客服。
403	CBC.0151	访问拒绝。
500	CBC.0999	未知错误。

父主题： 实名认证

上一篇：申请企业实名认证

下一篇：查询实名认证审核结果

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消