调用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 认证结果码。取值:
  • 200:认证通过。

    该结果将产生计费。

  • 201:(认证不通过)姓名和身份证不一致。

    该结果将产生计费。

    可能信息有误,建议用户确认后重新操作。

  • 202:(认证不通过)查询不到身份信息。

    该结果将产生计费。

    可能由于用户户口迁移、军人身份等特殊状态导致,建议预留人工审核入口,进行人工审核。

说明 使用卡证核身识别模式时(调用身份证核验初始化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 描述
200 success 接口响应成功。
400 参数不能为空 参数不能为空。
406 无效的certifyId 无效的CertifyId
410 未开通服务 未开通OSS产品或未完成OSS读写授权。
411 RAM无权限 需要给RAM用户授予AliyunYundunCloudAuthFullAccess的操作权限。
424 身份认证记录不存在 CertifyId还没有对应的身份认证提交记录。
500 系统错误 系统内部错误。