申请个人实名认证
接口约束
- 接口只允许使用解决方案提供商或华为云总经销商（一级经销商）的AK/SK或者Token调用。
- 伙伴必须在伙伴中心的“服务支持 > 能力开放 > 接入配置”页面中开启“实名认证附件上传”后，才能调用该接口。
- 实名认证的图片，必须上传到桶的download目录下面。
- 通过调用接口的方式进行个人实名认证仅支持个人证件认证和个人银行卡认证方式。
调试
您可以在API Explorer中调试该接口。
URI
POST /v2/customers/realname-auths/individual
请求消息
请求参数
|
参数 |
是否必选 |
参数类型 |
取值范围 |
描述 |
|---|---|---|---|---|
|
customer_id |
是 |
String |
最大长度：64 |
客户账号ID。您可以调用查询客户列表接口获取customer_id。 |
|
identify_type |
是 |
Integer |
- |
认证方案： 0：个人证件认证 4：个人银行卡认证 |
|
verified_file_url |
是 |
List<String> |
最大长度：4 |
|
|
name |
是 |
String |
最大长度：255 |
姓名。 |
|
verified_number |
是 |
String |
最大长度：32 |
证件号码。 |
|
xaccount_type |
是 |
String |
最大长度：64 |
华为分给合作伙伴的平台标识。 该标识的具体值由华为分配。获取方法请参见如何获取xaccountType的取值。 |
|
verified_type |
否 |
Integer |
- |
证件类型： 0：身份证，上传的附件为3张，第1张是身份证人像面，第2张是身份证国徽面，第3张是个人手持身份证人像面； 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。 |
|
参数 |
是否必选 |
参数类型 |
取值范围 |
描述 |
|---|---|---|---|---|
|
bank_account |
是 |
String |
最大长度：35 |
银行卡账号。 当identifyType为4时，不能为空。 银行账号输入规则：^[0-9]{0,35}$。 |
|
areacode |
是 |
String |
最大长度：10 |
国家/区号码。 例如：0086：中国大陆区号码。 |
|
mobile |
是 |
String |
最大长度：20 |
手机号码。 |
|
verification_code |
是 |
String |
最大长度：6 |
验证码。 请调用“发送验证码”接口获取。 |
请求示例
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": 0, "xaccount_type": "***_IDP" }
响应消息
响应参数
状态码：200
|
参数 |
参数类型 |
取值范围 |
描述 |
|---|---|---|---|
|
is_review |
Integer |
- |
是否需要转人工审核，只有状态码为200才返回该参数：
|
状态码：400
|
参数 |
参数类型 |
取值范围 |
描述 |
|---|---|---|---|
|
error_code |
String |
最大长度：16 |
状态码。具体请参考状态码。只有失败才会返回这个参数。 |
|
error_msg |
String |
最大长度：1024 |
错误描述信息。只有失败才会返回这个参数。 |
|
is_review |
Integer |
- |
是否需要转人工审核，只有状态码为200才返回该参数：
|
|
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 |
抱歉，华为云暂无法审核您提交的实名认证信息，请联系您的客户经理协助。 |
|
403 |
CBC.0151 |
访问拒绝。 |
|
500 |
CBC.0999 |
其他错误。 |
