全部产品
Search

搜索本产品

    ID Verification：同步调用

    文档中心

    ID Verification：同步调用

    更新时间：Sep 21, 2026

    本文介绍凭证识别服务的API接口。传入凭证图片或PDF文件，通过AI提取关键信息，并支持凭证伪造检测。此接口为同步调用，调用结束后直接返回结果。

    接口信息

    • 接口名：CredentialRecognitionIntlV2

    • 接口说明：传入凭证图片或PDF文件，通过AI提取关键信息，并支持凭证伪造检测。

    • 请求方法：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

    CredentialOcrPictureBase64

    String

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

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

    base64

    CredentialOcrPictureUrl

    String

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

    https://***.jpg

    CredentialOcrPictureFile

    InputStream

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

    FileInputType

    String

    否

    入参文件类型。

    • IMAGE：图片（默认）；

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

    IMAGE

    DocType

    String

    是

    凭证类型：

    • 01：交易凭据（包括：水、电、煤、信用卡等各类电子账单图片）

    • 03：转账交易流水

    • 04：poa地址证明

    01

    OcrArea

    String

    是

    提取类型：

    • 0101：电子账单地址和姓名模块（通过智能分析提取地址及姓名模块）

    • 0301：转账交易流水金额信息

    • 0401：poa凭证提取信息

    0101

    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****

    ResultObject.TransactionId

    String

    整个流程的唯一标识。

    hksb7ba1b28130d24e015d694361b****

    Code

    String

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

    重要

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

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

    Success

    Message

    String

    返回信息的响应消息。

    success

    ResultObject.Success

    String

    提取结果：

    • S：成功

    • F：失败

    S

    ResultObject.SubCode

    String

    认证结果描述。更多信息，请参见ResultObject.SubCode错误码说明。

    200

    ResultObject.ExtIdInfo

    String

    关于JSON格式，请参见右侧示例。更多信息，请参见ResultObject.ExtIdInfo。

    • 请求参数OcrArea为0101时：

      {
  // 当开启篡改检测（请求参数FraudCheck = true）时，将输出spoofInfo
  "spoofInfo":
  {
    "spoofResult": "Y",
    "spoofType": "PS,SCREEN_PHOTO,ORIGINAL_PHOTO"
  },
  "recInfo":
  {
    "address": "浙江省杭州市萧山区盈丰街道***",
    "name": "张三"
  }
}

    • 请求参数OcrArea为0301时：

      {
  // 当开启篡改检测（请求参数FraudCheck = true）时，将输出spoofInfo
  "spoofInfo":
  {
    "spoofResult": "Y",
    "spoofType": "PS,SCREEN_PHOTO,ORIGINAL_PHOTO"
  },
  "recInfo":
  {
    "money": "$41.41"
  }
}

    • 请求参数OcrArea为0401时：

      {
  "translateInfo": {
    "address_t": "1/176-C China",
    "name_t": "SSS SSS SSS"
  },
  "standardInfo": {
    "date_of_issue_s": "2010-06-05"
  },
  "spoofInfo": "{'spoofResult':'Y','spoofType':'PS,SCREEN_PHOTO','ORIGINAL_PHOTO'}",
  "checkInfo": {
    "address_rule": "Y",
    "date_of_issue_rule": "Y",
    "name_rule": "Y"
  },
  "recInfo": "{'address':'1/176-C China','date_of_issue':'06/05/2010','name':'SSS SSS SSS'}"
}

    ResultObject.SubCode错误码说明

    错误码

    是否计费

    描述和原因建议

    200

    是

    提取成功。

    204

    是

    关键信息核验不一致。

    211

    是

    文件质量或分辨率不符合要求，请确保文件清晰、曝光正常，完整无遮挡，角度无太大偏差。

    212

    是

    防伪检测存在风险。可能存在翻拍、篡改、复印等高风险操作。

    213

    是

    文件类型不符合，请确保文件类型和传入证件类型一致。

    ResultObject.ExtIdInfo

    名称

    类型

    描述

    示例值

    recInfo

    String

    提取的关键信息。

    说明

    如果提取失败，则该字段值为空。

    • 请求参数OcrArea为0101时：

      {
  "address": "浙江省杭州市萧山区盈丰街道***",
  "name": "张三"
}

    • 请求参数OcrArea为0301时：

      {
  "money": "$41.41"
}

    spoofInfo

    String

    证件防伪检测结果，包括风险判定结果和风险类型：

    • spoofResult：

      • Y：存在风险

      • N：正常

    • spoofType：

      • PS：图片PS

      • SCREEN_PHOTO：屏幕翻拍

      • SCREENSHOT：屏幕截屏

      • ORIGINAL_PHOTO：非原始图

    开启篡改检测（请求参数FraudCheck = true）输出此结果。

    {
  "spoofResult": "Y",
  "spoofType": [
    "PS"
  ]
}