申请个人实名认证-CreatePersonalRealnameAuth

功能介绍

个人客户可以进行个人实名认证申请。

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

接口约束

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

调试

您可以在API Explorer中调试该接口。

授权信息

操作员账号调用当前API需经过授权，您可以通过伙伴中心为操作员赋予相应权限项来完成授权。有关如何为角色授权的详细信息，请参见为组织人员分配权限。

接口对应的权限项如下：

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

URI

POST /v2/customers/realname-auths/individual

请求消息

请求参数

参数	是否必选	参数类型	取值范围	描述
customer_id	是	String	最大长度：64	客户账号ID。您可以调用查询客户列表-ListSubCustomers接口获取customer_id。
identify_type	是	Integer	-	认证方案： 0：个人证件认证 4：个人银行卡认证
verified_file_url	是	List<String>	最大长度：4	个人证件认证时证件附件的文件URL，该URL地址必须按照顺序填写。以护照举例，譬如护照个人资料页文件名称是abc023，护照入境盖章页是def004，手持护照个人资料页是gh007，那么这个地方需要按照 abc023 def004 gh007 的顺序填写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。
name	是	String	最大长度：255	姓名。
verified_number	是	String	最大长度：32	证件号码。
xaccount_type	是	String	最大长度：64	华为分给合作伙伴的平台标识。该标识的具体值由华为分配。获取方法请参见如何获取xaccountType的取值。
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。

表1 BankCardInfo
参数	是否必选	参数类型	取值范围	描述
bank_account	是	String	最大长度：35	银行卡账号。当identifyType为4时，不能为空。银行账号输入规则：^[0-9]{0,35}$。
areacode	是	String	最大长度：10	国家/区号码。例如：0086：中国大陆区号码。
mobile	是	String	最大长度：20	手机号码。
verification_code	是	String	最大长度：6	验证码。请调用“发送验证码-SendVerificationMessageCode”接口获取。

请求示例

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：需要

参数

参数类型

取值范围

描述

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>	-	错误列表。

响应示例

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.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	其他错误。