文档首页 > > API参考> 待下线接口> 管理客户> 实名认证> 个人实名认证申请(旧)

个人实名认证申请(旧)

分享
更新时间: 2020/06/30 GMT+08:00

功能介绍

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

Web UI

个人客户可以在账号中心进行个人实名认证申请。

个人账号实名认证分为个人银行卡认证、扫码认证和个人证件认证三种方式,总体流程如下:

推荐您使用个人银行卡认证,个人银行卡认证简单易操作,认证时间相对较短。

REST API

个人客户在伙伴销售平台进行个人实名认证申请,目前支持个人证件和个人银行卡两种认证方式。

  • 接口只允许使用合作伙伴账号AK/SK或者Token调用。
  • 伙伴必须在伙伴中心的“服务支持 > 能力开放 > 接入配置”页面中开启“实名认证附件上传”后,才能调用该接口。
  • 实名认证的图片,必须上传到桶的download目录下面。

  1. URI

    POST /v1.0/{partner_id}/partner/customer-mgr/realname-auth/individual

    参数说明请参见下表。

    参数

    是否必选

    取值范围

    描述

    partner_id

    最大长度:64

    合作伙伴ID(华为分配)。

    获取方法请参见如何获取合作伙伴ID(partner_id)

  1. 请求消息

    请求参数

    参数

    是否必选

    参数类型

    取值范围

    描述

    customerId

    String

    最大长度:64

    客户账号ID。获取方法请参见如何获取客户的customer_id/domain_id

    identifyType

    Integer

    -

    认证方案:

    0:个人证件认证

    4:个人银行卡认证。这种方式下,仅仅需要上传一张个人扫脸的图片附件即可。

    verifiedType

    Integer

    -

    证件类型:

    0:身份证,上传的附件为3张,第1张是身份证人像面,第2张是身份证国徽面,第3张是个人手持身份证人像面;

    3:护照,上传的附件为3张,第1张是护照个人资料页,第2张是,护照入境盖章页,第3张是手持护照个人资料页;

    5:港澳通行证,上传的附件为3张,第1张是港澳居民来往内地通行证正面(人像面),第2张是港澳居民来往内地通行证反面,第3张是手持港澳居民来往内地通行证人像面;

    6:台湾通行证,上传的附件为3张,第1张是台湾居民来往大陆通行证正面(人像面),第2张是台湾居民来往大陆通行证反面,第3张是手持台湾居民来往大陆通行证人像面;

    7:海外驾照,上传的附件为2张,第1张是中国以外驾照正面照片(人像面),第2张是手持中国以外驾照人像面照片;

    9:港澳居民居住证,上传的附件为3张,第1张是港澳居民居住证人像面,第2张是,港澳居民居住证国徽面,第3张是手持港澳居民居住证人像面照片;

    10:台湾居民居住证,上传的附件为3张,第1张是台湾居民居住证人像面,第2张是台湾居民居住证国徽面,第3张是手持台湾居民居住证人像面照片。

    当identifyType=0的时候,该字段需要填写,否则忽略该字段的取值。

    verifiedFileURL

    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

    姓名。

    verifiedNumber

    String

    最大长度:32

    证件号码。

    changeType

    Integer

    [-1]

    变更类型:

    -1:首次实名认证

    xaccountType

    String

    最大长度:64

    华为分给合作伙伴的平台标识。

    该标识的具体值由华为分配。获取方法请参见如何获取xaccountType的取值

    bankCardInfo

    BankCardInfo

    -

    个人银行卡信息。

    当identifyType=4的时候,该字段需要填写,否则忽略该字段的取值。

    具体请参见表1

    表1 BankCardInfo

    参数

    是否必选

    参数类型

    取值范围

    描述

    bankAccount

    String

    最大长度:100

    银行卡账号。

    当identifyType为4时,不能为空。

    银行账号输入规则:^[0-9a-zA-Z],可以包含特殊横杠(-)字符。

    areacode

    String

    最大长度:10

    国家/区号码。

    例如:0086:中国大陆区号码。

    mobile

    String

    最大长度:20

    手机号码。

    verificationCode

    String

    最大长度:6

    验证码。

    请求示例

    POST  https://bss.myhuaweicloud.com/v1.0/{partner_id}/partner/customer-mgr/realname-auth/individual HTTP/1.1
    Content-Type: application/json
    X-Auth-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
    
    {
    	"customerId": "05******cb80",
    	"identifyType": 0,
    	"verifiedType": 5,
    	"verifiedFileURL": [
    		"gerenshiming/zhengmian001.jpg",
                    "gerenshiming/fanmian002.jpg",
                    "gerenshiming/laiwang003.jpg"
    	],
    	"name": "tom554",
    	"verifiedNumber": "xxxxxxxxxx",
    	"changeType": -1,
    	"xaccountType": "jing_hff_zh_IDP"
    }

  1. 响应消息

    响应参数

    参数

    是否必选

    参数类型

    取值范围

    描述

    error_code

    String

    最大长度:16

    状态码。具体请参考4。只有失败才会返回这个参数。

    error_msg

    String

    最大长度:1024

    错误描述信息。只有失败才会返回这个参数。

    isReview

    Integer

    N/A

    是否需要转人工审核,只有状态码为200才返回该参数:

    • 0:不需要
    • 1:需要

    failCheckItems

    List<String>

    N/A

    错误列表。具体请参见表2

    错误列表,只有CBC.7004才出现。

    表2 failCheckItems列表

    检查项ID

    检查项名称

    PIC_FORMAT_ERR

    传递的图片格式不正确。

    PIC_SIZE_ERR

    证件照图片尺寸不满足要求。

    INVALID_FRONT_IDCARD

    无效的身份证正面照或者身份证正面照模糊。

    INVALID_BACK_IDCARD

    无效的身份证反面照或者身份证反面照模糊。

    IDCARD_INFO_NOT_SAME

    输入的身份证信息与上传身份证正面照的信息不一致。

    INVALID_IDCARD_FACE

    手持证件照无效或者模糊。

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    Content-Length: length
    Date: response time  
    
    {
    	"isReview": 1,
    	"failCheckItems": []
    }

  1. 状态码

    HTTP状态码

    错误码

    错误描述

    400

    CBC.0100

    参数错误。

    400

    CBC.5002

    合作伙伴的客户不存在。

    400

    CBC.5004

    无对该客户的操作权限。

    400

    CBC.7151

    验证码失效。

    400

    CBC.7152

    验证码错误。

    400

    CBC.7188

    该客户已经实名认证或者实名认证在审核中。

    400

    CBC.7191

    客户实名认证次数超过最大配置值。

    400

    CBC.7202

    实名认证校验失败。

    400

    CBC.7219

    实名认证信息与人脸不匹配。

    400

    CBC.7255

    持卡人身份信息或手机号输入不正确。

    400

    CBC.7258

    银行卡状态不正确(可能是冻结或过期的银行卡)。

    400

    CBC.7259

    银行卡未开通认证支付(若您使用交通银行、北京银行、上海银行、广发银行、浦发银行或平安银行的银行卡进行个人实名认证,需要先开通此银行卡的银联在线支付)。

    400

    CBC.7261

    不支持该银行卡,请尝试其他银行卡。

    400

    CBC.7265

    您是合作伙伴,不允许实名认证为个人。

    403

    CBC.0151

    访问拒绝。

    500

    CBC.0999

    其他错误。

    500

    CBC.7004

    发起的业务操作存在不满足的业务检查项。

    500

    CBC.7189

    使用该证件号进行实名认证的客户数已经超过系统规定。

    500

    CBC.7193

    该证件号属于违规证件号,不允许进行实名认证。

    500

    CBC.7260

    银联与发卡行之间调用失败,请稍后重试或使用其它银行卡。

    500

    CBC.7262

    银行系统异常,网络异常。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问