获取审核链接详情

GET

/openapi/v3/audit-links/:id

获取指定审核链接的当前状态、终端用户已填写的组织/个人信息、已上传材料及审核进度。

status 的可选值为 created、auditing、passed、failed、expired；audit_type 为 person 或 organization。

Path 参数

参数	类型	必填	说明
id	string	是	审核链接 ID

返回数据

参数	类型	说明
business_id	string	业务标识
end_user_id	string	终端用户标识
product_id	string	产品 ID
status	string	审核链接状态
audit_type	string	审核类型
audit_method	string	审核链接入口选择的整体审核方式，取值见审核方式；尚未保存有效选择时省略
private_key_custody	boolean	是否由 CA/云签托管私钥。电子签名认证证书始终返回生效值；历史链接未记录时按 true 返回
field_config	object	字段配置
∟ immutable_paths	array[string]	页面实际生效的不可修改字段路径列表。创建时包含预授权对象则系统自动补入 preauthorization.enabled
ui_config	object	页面配置
∟ success_redirect_url	string	提交成功后的跳转地址
∟ end_redirect_url	string	流程结束后的跳转地址
∟ language	string	页面语言
∟ theme_color	string	主题色
∟ hide_header	boolean	是否隐藏页头
∟ hide_customer_service	boolean	是否隐藏审核页面的客服入口：true 隐藏、false 显示。值为 false 时也返回；历史链接默认 false
∟ privacy_agreement_url	string	隐私协议地址
person_info	object	个人型为申请人信息，机构型为联系人信息；基础级法人本人认证时该联系人即法人
∟ id	string	个人信息 ID
∟ name	string	完整姓名；优先返回提交的原文，缺少原文时由 first_name/last_name 回拼
∟ first_name	string	名（兼容字段）
∟ last_name	string	姓（兼容字段）
∟ job_title	string	职位
∟ telephone	string	电话
∟ id_type	string	证件类型
∟ id_number	string	证件号码
∟ email	string	联系人邮箱
∟ bank_card	string	预留银行卡号的脱敏值，例如 1234********1234；未填写时省略
∟ status	string	个人信息验证状态
∟ validation_until	string	验证有效期
∟ created_at	string	创建时间
organization	object	组织信息
∟ id	string	组织 ID
∟ name	string	组织名称
∟ address_line1	string	组织地址
∟ address_line2	string	组织地址 2
∟ city	string	城市
∟ state	string	省份
∟ postal_code	string	邮编
∟ country	string	国家地区代码
∟ telephone	string	组织电话
∟ biz_email	string	企业邮箱
∟ uscc	string	统一社会信用代码
∟ status	string	组织验证状态
∟ validation_until	string	验证有效期
∟ created_at	string	创建时间
∟ legal_person	object	法人信息（legal_representative 使用）；基础级 basic_legal 的法人本人信息见 person_info
∟∟ name	string	法人完整姓名；优先返回提交的原文，缺少原文时由 first_name/last_name 回拼
∟∟ first_name	string	法人名（兼容字段）
∟∟ last_name	string	法人姓（兼容字段）
∟∟ id_type	string	法人证件类型
∟∟ id_number	string	法人证件号码
∟∟ telephone	string	法人预留手机号
∟∟ bank_card	string	法人预留银行卡号的脱敏值，例如 1234********1234；未填写时省略
∟ bank_transfer_detail	object	对公打款明细（仅对公打款认证的组织返回）
∟∟ direction	string	打款方向：USER_TO_US 表示用户向平台打款，US_TO_USER 表示平台向用户打款
∟∟ account_name	string	账户名称
∟∟ account_no	string	银行账号
∟∟ bank_name	string	开户银行
∟∟ amount	number	打款金额，币种为人民币（CNY）
∟∟ remark	string	打款备注
∟∟ payment_fail_reason	string	打款失败原因
materials	array[object]	各材料类型的当前代表文件列表；同一类型存在多个文件时不保证全部列出
∟ material_type	string	材料类型
∟ filename	string	文件名
∟ source	string	材料来源
audit_details	object	审核进度详情
∟ progress_status	string	整体进度状态
∟ person_status	string	个人信息审核状态
∟ org_status	string	组织信息审核状态
∟ contact_status	string	联系人审核状态
∟ validation_until	string	验证有效期
∟ completed_at	string	审核完成时间
∟ reason	string	审核说明 / 失败原因

预授权详情边界

通过 prefill_data.preauthorization 创建的审核链接，详情中的 field_config.immutable_paths 会自动补入 preauthorization.enabled。期限模式锁 preauthorization.use_certificate_validity 仅在创建方显式锁定时返回。

次数/期限值锁按创建时的模式返回：自定义期限且有限次数时为 preauthorization.usage_limit、preauthorization.validity、preauthorization.validity_unit 三项；自定义期限且 usage_unlimited=true 时为后两项；至本证书到期且有限次数时仅为 preauthorization.usage_limit；至本证书到期且不限次数时没有次数/期限值锁。未锁定的路径不会因预设了对应值而自动加入。

本接口不返回预授权的 use_certificate_validity、usage_limit、validity、validity_unit 等配置值，也不返回 PIN 摘要、协议确认或审核证据。immutable_paths 仅说明哪些字段被锁定，不能据此推断期限模式是 true 还是 false。

调用方在审核通过后取得 person_info.id 或 organization.id 用于创建订单；组织订单无需重复提交审核链接中的联系人信息。

完整姓名与兼容字段

通过 name 创建的审核链接会返回提交的姓名原文，并保留拆分后的 first_name/last_name 兼容字段。使用兼容字段创建或旧链接没有姓名原文时，系统会由已有的 first_name/last_name 回拼 name。

银行卡号已脱敏

bank_card 只保留前 4 位和后 4 位，中间位置以 * 替换。接口不返回完整银行卡号。

验证失败后修改

在验证完成前（包括人脸认证失败后），终端用户可在审核链接页面返回修改实际验证对象的个人、机构联系人或法人信息，并重新提交验证。法人信息在验证完成前可修改。

审核方式

audit_method 表示终端用户在审核链接入口选择的整体审核方式。CA 后续将某个主体切换为面对面审核时，不会因此改写本字段；尚未保存有效选择时不返回。

audit_method	适用产品或场景	含义
name_idcard_mobile	个人基础级	姓名、证件、手机号三要素认证
name_idcard_bankcard_mobile	支持银行卡验证的个人基础级	姓名、证件、银行卡、手机号四要素认证
basic_legal	机构基础级	法人本人认证，联系人与法人为同一人
basic_contact	机构基础级	非法人联系人认证
face_recognition	支持人脸识别的个人产品及兼容的历史个人链接	人脸识别认证
legal_representative	支持法人代表认证的机构产品	法人代表认证
bank_transfer	支持对公打款认证的机构产品	对公打款认证

基础级个人新提交的审核方式会按实际使用的银行卡信息确定：无银行卡为 name_idcard_mobile，有银行卡且产品支持时为 name_idcard_bankcard_mobile。历史链接仍可能返回 face_recognition，接收方应保留兼容处理。

请求示例

curl -G 'https://api.certcloud.cn/openapi/v3/audit-links/al_7Kd9Qm2x' \
  -H 'X-CC-Auth-Key: your-auth-key' \
  -H 'X-CC-Key-ID: your-key-id'

const response = await fetch('https://api.certcloud.cn/openapi/v3/audit-links/al_7Kd9Qm2x', {
  method: 'GET',
  headers: {
    'X-CC-Auth-Key': 'your-auth-key',
    'X-CC-Key-ID': 'your-key-id',
  }
})
const data = await response.json()

req, _ := http.NewRequest("GET", "https://api.certcloud.cn/openapi/v3/audit-links/al_7Kd9Qm2x", nil)
req.Header.Set("X-CC-Auth-Key", "your-auth-key")
req.Header.Set("X-CC-Key-ID", "your-key-id")
resp, err := http.DefaultClient.Do(req)

import requests

response = requests.get(
    'https://api.certcloud.cn/openapi/v3/audit-links/al_7Kd9Qm2x',
    headers={
        'X-CC-Auth-Key': 'your-auth-key',
        'X-CC-Key-ID': 'your-key-id',
    }
)
data = response.json()

响应示例

以下为机构基础级选择法人本人认证后的详情，法人本人资料位于 person_info。

以下响应示例中的企业名称已脱敏，仅用于展示字段结构。

200成功

{
  "data": {
    "business_id": "biz-20260601-001",
    "end_user_id": "000000001",
    "product_id": "trustasia_ide_bipc",
    "status": "auditing",
    "audit_type": "organization",
    "audit_method": "basic_legal",
    "private_key_custody": true,
    "field_config": {
      "immutable_paths": [
        "organization.name",
        "preauthorization.enabled"
      ]
    },
    "ui_config": {
      "language": "zh-CN",
      "hide_header": false,
      "hide_customer_service": true
    },
    "person_info": {
      "name": "示例姓示例名",
      "first_name": "示例名",
      "last_name": "示例姓",
      "telephone": "138****0000",
      "bank_card": "1234********1234"
    },
    "organization": {
      "id": "yAvsAzQ6",
      "name": "亚数****有限公司",
      "country": "CN",
      "status": "ca_auditing",
      "created_at": "2026-06-01 12:05:00"
    },
    "materials": [
      {
        "material_type": "business_license",
        "filename": "license.pdf",
        "source": "end_user"
      }
    ],
    "audit_details": {
      "progress_status": "auditing",
      "org_status": "ca_auditing"
    }
  },
  "code": "success"
}