# 申请个人实名认证-CreatePersonalRealnameAuth #### 功能介绍 个人客户可以进行个人实名认证申请。 客户登录账号中心进行个人实名认证的方式及流程请参见[这里](https://support.huaweicloud.com/usermanual-account/zh-cn_topic_0077914254.html)。 #### 接口约束 - 接口只允许使用解决方案提供商或华为云总经销商（一级经销商）的AK/SK或者Token调用。 - 伙伴必须在伙伴中心的"[服务支持 \> 能力开放 \> 接入配置](https://support.huaweicloud.com/devg-bpconsole/access_00011.html)"页面中开启"实名认证附件上传"后，才能调用该接口。 - 实名认证的图片，必须上传到桶的download目录下面。 - 通过调用接口的方式进行个人实名认证仅支持个人证件认证和个人银行卡认证方式。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=BSS&api=CreatePersonalRealnameAuth)中调试该接口。 #### 授权信息 操作员账号调用当前API需经过授权，您可以通过伙伴中心为操作员赋予相应权限项来完成授权。有关如何为角色授权的详细信息，请参见[为组织人员分配权限](https://support.huaweicloud.com/usermanual-bpconsole/zh-cn_topic_0072435164.html)。 接口对应的权限项如下： | 权限项 | 权限项名称 | |:---|:---| | BPC_ITEM_SUBCUSTSERV_010119 | 销售-客户-客户管理-客户列表-实名认证同步（能力开放） | #### URI POST /v2/customers/realname-auths/individual #### 请求消息 **请求参数** | 参数 | 是否必选 | 参数类型 | 取值范围 | 描述 | |:---|:---|:---|:---|:---| | customer_id | 是 | String | 最大长度：64 | 客户账号ID。您可以调用[查询客户列表-ListSubCustomers](https://support.huaweicloud.com/api-bpconsole/mc_00021.html)接口获取customer_id。 | | identify_type | 是 | Integer | - | 认证方案： 0：个人证件认证 4：个人银行卡认证 | | verified_file_url | 是 | List\ | 最大长度：4 | 1. 个人证件认证时证件附件的文件URL，该URL地址必须按照顺序填写。 以护照举例，譬如护照个人资料页文件名称是abc023，护照入境盖章页是def004，手持护照个人资料页是gh007，那么这个地方需要按照 abc023 def004 gh007 的顺序填写URL（文件名称区分大小写）。 2. 个人银行卡认证时直接上传一张个人扫脸的图片附件即可。 3. 证件附件目前仅仅支持jpg、jpeg、bmp、png、gif、pdf格式，单个文件最大不超过10M。 4. 这个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。 | | name | 是 | String | 最大长度：255 | 姓名。 | | verified_number | 是 | String | 最大长度：32 | 证件号码。 | | xaccount_type | 是 | String | 最大长度：64 | 华为分给合作伙伴的平台标识。 该标识的具体值由华为分配。获取方法请参见[如何获取xaccountType的取值](https://support.huaweicloud.com/api-bpconsole/bpconsole_apifaq_00002.html)。 | | verified_type | 否 | Integer | - | 证件类型： 3：护照，上传的附件为3张，第1张是护照个人资料页，第2张是，护照入境盖章页，第3张是手持护照个人资料页； 5：港澳通行证，上传的附件为3张，第1张是港澳居民来往内地通行证正面（人像面），第2张是港澳居民来往内地通行证反面，第3张是手持港澳居民来往内地通行证人像面； 6：台湾通行证，上传的附件为3张，第1张是台湾居民来往大陆通行证正面（人像面），第2张是台湾居民来往大陆通行证反面，第3张是手持台湾居民来往大陆通行证人像面； 9：港澳居民居住证，上传的附件为3张，第1张是港澳居民居住证人像面，第2张是，港澳居民居住证国徽面，第3张是手持港澳居民居住证人像面照片； 10：台湾居民居住证，上传的附件为3张，第1张是台湾居民居住证人像面，第2张是台湾居民居住证国徽面，第3张是手持台湾居民居住证人像面照片。 当identify_type=0的时候，该字段需要填写，否则忽略该字段的取值。 | | change_type | 否 | Integer | \[-1\] | 变更类型： -1：首次实名认证 | | bank_card_info | 否 | BankCardInfo Object | - | 个人银行卡信息。 当identify_type=4的时候，该字段需要填写，否则忽略该字段的取值。 具体请参见[表1]。 | 表1BankCardInfo | 参数 | 是否必选 | 参数类型 | 取值范围 | 描述 | |:---|:---|:---|:---|:---| | bank_account | 是 | String | 最大长度：35 | 银行卡账号。 当identifyType为4时，不能为空。 银行账号输入规则：\^\[0-9\]{0,35}$。 | | areacode | 是 | String | 最大长度：10 | 国家/区号码。 例如：0086：中国大陆区号码。 | | mobile | 是 | String | 最大长度：20 | 手机号码。 | | verification_code | 是 | String | 最大长度：6 | 验证码。 请调用"[发送验证码-SendVerificationMessageCode](https://support.huaweicloud.com/api-bpconsole/mc_00024.html)"接口获取。 | **请求示例** ``` POST https://bss.myhuaweicloud.com/v2/customers/realname-auths/individual HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ { "verified_number": "949826********2922", "verified_file_url": [ "shimingrenzheng/zhengmian001.jpg", "shimingrenzheng/fanmian002.jpg" ], "name": "wangx_****_001", "change_type": -1, "customer_id": "068a6d********288536b6ba57d1ffae", "verified_type": 3, "identify_type": 6, "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\ | - | 错误列表。 | **响应示例** ``` HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time { "is_review": "1" } ``` #### 状态码 ![](https://support.huaweicloud.com/api-bpconsole/public_sys-resources/note_3.0-zh-cn.png) - 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 - 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 | HTTP状态码 | 错误码 | 错误描述 | |:---|:---|:---| | 400 | CBC.99000027 | 验证码过期。 | | 400 | CBC.99000035 | 非合作伙伴子客户。 | | 400 | CBC.99000099 | 客户实名认证时证件附件的文件大小超过最大配置值。 | | 400 | CBC.99000100 | 客户实名认证时证件附件的文件格式不正确。 | | 400 | CBC.99005030 | 伙伴未开通实名认证功能或者桶鉴权失败。 | | 400 | CBC.99007188 | 该客户已经实名认证或者实名认证在审核中。 | | 400 | CBC.99007189 | 使用该证件号进行实名认证的客户数已经超过系统规定。 | | 400 | CBC.99007191 | 客户实名认证次数超过最大配置值。 | | 400 | CBC.99007193 | 该证件号属于违规证件号，不允许进行实名认证。 | | 400 | CBC.99007202 | 实名认证校验失败。 | | 400 | CBC.99007219 | 实名认证信息与人脸不匹配。 | | 400 | CBC.99007255 | 持卡人身份信息或手机号输入不正确。 | | 400 | CBC.99007258 | 银行卡状态不正确（可能是冻结或过期的银行卡）。 | | 400 | CBC.99007261 | 不支持该银行卡，请尝试其他银行卡。 | | 400 | CBC.99007260 | 银联与发卡行之间调用失败，请稍后重试或使用其它银行卡。 | | 400 | CBC.99007262 | 银行系统异常，网络异常。 | | 400 | CBC.0100 | 参数错误。 | | 400 | CBC.70600026 | 抱歉，华为云暂无法审核您提交的实名认证信息，请联系您的客户经理协助。 | | 400 | CBC.70600032 | 操作失败，身份信息异常，存在违规风险，如有疑问请提工单咨询客服。 | | 403 | CBC.0151 | 访问拒绝。 | | 500 | CBC.0999 | 其他错误。 |