文档

银行卡核验结果查询

更新时间:

调用DescribeSmartVerify查询银行卡核验的结果。

接口说明

接口名:DescribeSmartVerify

服务地址:cloudauth.cn-shanghai.aliyuncs.com(上海地域)或cloudauth.cn-beijing.aliyuncs.com(北京地域)。

请求方法:HTTPS POST和GET。

接口描述:当接入方的移动端收到回调之后,其服务端可以调用此接口,获取相应的认证状态和认证资料。

请求参数

名称

类型

是否必选

示例值

描述

SceneId

Long

100000xxxx

认证场景ID。

您必须先在增强版实人认证控制台创建认证场景,才能获得认证场景ID。更多信息,请参见添加认证场景

CertifyId

String

91707dc296d469ad38e4c5efa6a0xxxx

认证请求ID。

必须先调用银行卡核验初始化提交认证请求,才能获得认证请求ID。

返回数据

名称

类型

是否必选

示例值

描述

RequestId

String

130A2C10-B9EE-4D84-88E3-5384FF039795

请求ID。

Message

String

success

错误信息。

Code

String

200

返回码,200表示接口响应成功。

ResultObject.Passed

String

T

认证是否通过。取值:

  • T:通过。

  • F:不通过。

说明

使用卡证核身识别模式时(调用银行卡核验初始化Mode选择OCR),默认返回T

ResultObject.SubCode

String

200

认证结果码。SubjectCode详情,请参见SubCode说明

说明

使用卡证核身识别模式时(调用身份证核验初始化Mode选择OCR),默认返回200

ResultObject.MaterialInfo

String

认证主体的附件信息,包括识别结果信息、图片类材料等。使用JSON格式的字符串表示,JSON结构体包含以下参数:

  • ocrIdCardInfo:字符串类型,身份证号。

  • ocrPictureInfo:JSON字符串类型,采集的认证照片信息。

    JSON结构体包含以下参数:

    • ossBucketName:String类型,身份证照片存储在您上海地域的OSS Bucket中,此处返回存储照片的Bucket名称。

    • ossBankCardObjectName:String类型,银行卡正面的文件名。

    • ossBankCardUrl:String类型,银行卡照片Url。

      说明

      返回的链接在15分钟内有效。

  • ocrBankCardInfo:JSON字符串类型,银行卡号。

    JSON结构体包含以下参数:

    • bankCardNo:String类型,银行卡号。

示例

请参见银行卡核验初始化

说明

如果您需要其他语言的SDK代码示例,您可以通过OpenAPI开发者门户在线调试工具调试API接口。运行成功后,OpenAPI开发者门户可以自动生成SDK代码示例。

Code和Message说明

Code

Message

描述

200

success

接口响应成功。

400

参数不能为空

参数不能为空。

403

异常重复调用

异常重复调用次数超限。

406

无效的CertifyId

无效的CertifyId

410

未开通服务

未开通OSS产品或未完成OSS读写授权。

411

RAM无权限

需要给RAM用户授予AliyunYundunCloudAuthFullAccess的操作权限。

424

身份认证记录不存在

CertifyId还没有对应的身份认证提交记录。

500

系统错误

系统内部错误。

SubCode说明

SubCode

是否计费

描述

200

认证通过。

201

实名校验不通过。认证不通过。可能导致失败的原因:用户的身份信息不匹配、信息有误或查询不到身份信息。

202

认证不通过。可能导致失败的原因:用户发生户口迁移、用户为军人等特殊状态。建议预留人工审核入口,用于人工审核。

203

认证信息不一致,银行卡未开通认证支付。

204

认证信息不一致,银行卡已过期。

205

认证信息不一致,银行卡为受限制的卡。

206

认证信息不一致,此卡被没收。

207

认证信息不一致,银行卡无效。

208

认证信息不一致,此卡无对应发卡行。

209

认证信息不一致,该卡未初始化或睡眠卡。

210

认证信息不一致,此卡为作弊卡、吞卡。

211

认证信息不一致,此卡已挂失。

212

认证信息不一致,密码错误次数超限。

213

认证信息不一致,发卡行不支持此交易。

214

认证信息不一致,卡状态不正常或卡无效。

215

认证信息不一致,未预留手机号。

216

认证信息不一致,输入的密码、有效期或CVN2有误。

217

认证信息不一致,其他卡异常情况。

218

无法验证,银行卡不支持该业务。

219

无法验证,验证失败或银行拒绝验证,请联系发卡行。

220

无法验证,银行卡暂不支持手机号验证。

221

无法验证,银行卡号有误。

202

查询不到身份信息。认证不通过。可能导致失败的原因:用户发生户口迁移、用户为军人等特殊状态。建议预留人工审核入口,用于人工审核。

222

无法验证,验证次数超限。

  • 本页导读