全部产品
Search

搜索本产品

    ID Verification：提交任务

    文档中心

    ID Verification：提交任务

    更新时间：Sep 21, 2026

    本文介绍凭证识别异步服务提交识别任务API。异步服务需要先调用本接口。

    接口信息

    • 接口名：CredentialSubmitIntlV2

    • 接口说明：凭证识别异步服务提交查询任务接口。

    • 请求方法：POST

    • 传输协议：HTTPS

    • QPS限量：API独享QPS限量，详情请参见服务端API QPS限量说明。

    • 服务地址：

      说明

      • 内网访问优势：内网指阿里云同一地域内各产品间的私有通信网络。若您的业务服务器部署于阿里云对应地域，请使用内网域名访问 ID Verification 服务，以获得更安全、稳定的通信质量。 

      • 海外访问优化建议：海外网络环境复杂，建议参考服务端网络耗时优化，优化集成方案，降低网络延迟及请求失败概率。

      新加坡

      • 公网：cloudauth-intl.ap-southeast-1.aliyuncs.com

      • 内网：cloudauth-intl-vpc.ap-southeast-1.aliyuncs.com

    说明

    1. 凭证识别伪造检测功能属于AI预测类产品，内部测试集样本准确率是90%，实际准确率由于样本场景的差异可能有波动。

    2. 电子合成图片类图片PS检测难度较大，原生相机拍摄图片检测效果优于电子合成图片。

    3. 伪造检测不建议作为凭证真实性判断的唯一方法，可作为辅助审核依据，或作为人工审核提效工具。

    4. 伪造检测金融支付收单、电商商家入驻等电子资料审核场景已经得到广泛的运用，有效提升人审效率，如果您有更广泛场景需求，请联系您的商务经理。

    在线调试和集成

    说明

    在调试和集成前，请确保您已完整阅读使用OpenAPI文档，充分了解API接口在OpenAPI平台的调用方式和SDK及其代码的获取方式。

    您可以在OpenAPI Explorer中直接运行本接口进行调试，并生成本接口的SDK代码示例。

    请求参数

    参数 CredentialOcrPictureBase64、CredentialOcrPictureUrl 或 CredentialOcrPictureFile 对应的文件必须符合以下规则：

    • 传参方式：三种上传方式任选其一。

    • 文件格式：FileInputType=IMAGE（默认）时支持 PNG、JPG、JPEG、BMP 和 WebP 格式；FileInputType=PDF 时支持 PDF 格式。

    • 文件尺寸：图片长宽需要大于15像素，小于8192像素，且长宽比需要小于50。

    • 文件大小：不能超过10MB。

    说明

    • 为了确保较好的识别效果，建议图像的长宽均大于500像素。

    • 文件过大会影响接口响应速度，建议使用小于 3MB文件。

    名称

    类型

    是否必选

    描述

    示例值

    ProductCode

    String

    是

    固定取值：CREDENTIAL_RECOGNITION。

    CREDENTIAL_RECOGNITION

    SceneCode

    String

    否

    您自定义的认证场景ID，用于后续控制台输入此场景ID查询相关记录。支持长度最多10位的字母、数字或下划线的组合。

    1234567890

    MerchantBizId

    String

    是

    您自定义的业务唯一标识，用于后续定位排查问题。支持长度最多为32位的字母和数字的组合，请确保唯一。

    说明

    阿里云服务器不会对该字段的值进行唯一性检查。为了更好地跟踪，强烈建议保证字段唯一。

    -

    CredentialOcrPictureBase64

    String

    否，三种上传方式任选其一即可。

    图片或PDF文件的Base64编码。选择此方式传入时，请注意检查文件大小，不要传入过大的文件。

    base64

    CredentialOcrPictureUrl

    String

    图片或PDF文件地址，公网可访问的HTTP、HTTPS链接。

    https://***.jpg

    CredentialOcrPictureFile

    InputStream

    凭证文件流。具体接入方式，请参见特殊场景：文件上传 Advance 接口配置。

    FileInputType

    String

    否

    入参文件类型。

    • IMAGE：图片（默认）；

    • PDF：PDF 文件，系统自动提取 PDF第一页进行识别。

    IMAGE

    DocType

    String

    是

    凭证类型：

    • 02：车辆登记证明

    02

    OcrArea

    String

    是

    提取类型：

    • 0201：泰国车辆登记证明

    0201

    FraudCheck

    String

    是

    是否开启篡改检测

    • true：开启

    • false：关闭

    true

    CheckRuleConfig

    String

    否

    字段校验规则配置，JSON 字符串格式。

    {
  "address_rule": "Includes Adrress 杭州市***",
  "name_rule": "Includes Name 张*",
  "date_of_issue_rule": "Whthin 2026.05.20"
}

    OcrValueStandard

    String

    否

    是否开启 OCR 结果标准化。

    • 0：关闭（默认）

    • 1：开启

    0

    OcrTranslation

    String

    否

    是否开启翻译。

    • 0：关闭（默认）

    • 1：开启

    0

    响应参数

    名称

    类型

    描述

    示例值

    HTTP Status Code

    Integer

    HTTP状态码。

    200

    HTTP Body

    RequestId

    String

    请求ID。

    130A2C10-B9EE-4D84-88E3-5384FF039****

    Result.TransactionId

    String

    整个流程的唯一标识。

    hksb7ba1b28130d24e015d694361b****

    Code

    String

    返回Code，具体信息请参见服务端返回HTTP状态码说明。

    重要

    • 此参数代表是否正确调用了接口。

    • 业务核验结果请通过ResultObject中的字段查看。

    Success

    Message

    String

    返回信息的响应消息。

    success