申请个人实名认证
接口约束
- 接口只允许使用合作伙伴账号AK/SK或者Token调用。
- 伙伴必须在伙伴中心的“权益与支持 > 能力开放 > 接入配置”页面中开启“实名认证附件上传”后，才能调用该接口。
- 实名认证的图片，必须上传到桶的download目录下面。
- 通过调用接口的方式进行个人实名认证仅支持个人证件认证方式。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
POST /v2/customers/realname-auths/individual
请求消息
请求参数
|
参数 |
是否必选 |
参数类型 |
取值范围 |
描述 |
|---|---|---|---|---|
|
customer_id |
是 |
String |
最大长度：64 |
客户账号ID。您可以调用查询客户列表接口获取customer_id。 |
|
identify_type |
是 |
Integer |
- |
认证方案： 0：个人证件认证 |
|
verified_file_url |
是 |
List<String> |
最大长度：4 |
|
|
name |
是 |
String |
最大长度：255 |
姓名。 |
|
verified_number |
是 |
String |
最大长度：32 |
证件号码。 |
|
xaccount_type |
是 |
String |
最大长度：64 |
华为分给合作伙伴的平台标识。 该标识的具体值由华为分配。获取方法请参见如何获取xaccountType的取值。 |
|
verified_type |
否 |
Integer |
- |
证件类型： 3：护照，上传的附件为2张，第1张是护照个人资料页，第2张是手持护照个人资料页； 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：首次实名认证 |
请求示例
POST https://bss-intl.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.99007261 |
不支持该银行卡，请尝试其他银行卡。 |
|
400 |
CBC.0100 |
参数错误。 |
|
400 |
CBC.70600026 |
抱歉，华为云暂无法审核您提交的实名认证信息，请联系您的客户经理协助。 |
|
403 |
CBC.0151 |
访问拒绝。 |
|
500 |
CBC.0999 |
其他错误。 |
