调用DescribeSmartVerify查询银行卡核验的结果-阿里云帮助中心

调用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	否	无法验证，验证次数超限。