Cobre 的 Evidence Requests API 提供了一套安全、可审计且结构化的机制，用于请求、收集和审查 合规、欺诈防范及风险管理 流程所需的支撑材料与信息。

该跨功能服务与平台核心资源（如 Money Movements、Counterparties 和 Destinations）集成，使 Cobre 与客户能够在需要额外证据以满足监管或内部控制要求时高效协作。

Evidence Requests 遵循清晰的生命周期，由通知、安全上传 和 结构化提交 驱动，确保透明度、可追溯性和运营可靠性。

创建 Evidence Requests（概念概述）

Evidence Requests 由 Cobre 发起，并通过 通知与订阅 功能下发给客户。
客户 不直接创建 Evidence Requests，而是通过提交所需的文件和信息来响应请求。

要接收 Evidence Requests，客户须订阅以下事件：

evidence-request.ask

订阅后，每当有新的 Evidence Request 创建时，客户将收到一条 Webhook 通知。

Evidence Requests 生命周期

通知
系统向客户发送一条 Webhook，包含 evidence_request_id、截止日期、上下文及所需证据类型。

证据提交
客户通过以下方式提交所需证据：

文件 → 使用签名 URL 上传

信息 → 以结构化 JSON 载荷提交

完成
提交完成（或截止日期到期）后，请求状态转换为 completed。

客户 每条 Evidence Request 仅可提交一次，不允许后续重复提交。

Evidence Request 通知

客户在订阅 evidence-request.ask 后，通过 Notifications API 接收 Evidence Requests。

通知结构

{
  "id": "ev_1234567890",
  "event_key": "evidence-request.ask",
  "event_type": "EvidenceRequest",
  "timestamp": "2024-06-01T12:00:00.000Z",
  "content": {
    "evidence_request_id": "evr_01923801823",
    "evidence_request_context": {
      "counterparty_id": "cp_456"
    },
    "evidence_request_description": "Please provide the required documents and information.",
    "evidence_requested": {
      "documents": ["doc_funds"],
      "information": ["information_counterparty_id"]
    }
  }
}

Evidence Request 上下文

evidence_request_context 对象用于标识触发 Evidence Request 的来源，帮助客户将其与内部系统关联。

上下文字段

字段	描述
`counterparty_id`	与请求关联的交易对手方
`mm_id`	触发请求的 Money Movement
`destination_id`	目标资源标识符
`destination_id_type`	目标方身份证件类型（例如 RFC、NIT）
`destination_id_number`	目标方身份证件号码
`destination_full_name`	目标方全名
`start_date`	本证据请求审查期间的开始日期
`end_date`	本证据请求审查期间的结束日期
`total_amount`	审查中资金流动的总金额（整币单位）
`total_money_movements`	与该证据请求关联的资金流动总笔数
`destination_account_number`	目标账户号码
`destination_provider_id`	目标账户所属金融机构或服务商 Id

并非所有字段都会出现在每条请求中。上下文内容取决于触发 Evidence Request 的具体原因。

证据类型目录

证据可以两种格式请求：文件和信息。

Document Types

Information Types

文件类型	预期证据
`doc_funds`	资金证明及异常资金流动说明
`official_identification_copy`	政府签发的身份证件（护照、驾照等）
`identification_and_address_copy`	政府签发的身份证件及地址证明
`proof_of_life_evidence`	入驻活体自拍或活体验证日志
`kyc_files`	为该客户收集的一份或多份 KYC 文件（PDF、截图、档案）

信息结构

data 载荷的形态取决于正在履行的 information_type。

information_counterparty_id

freeze_of_funds

每个字段单独均为可选，但整个载荷不能完全为空——必须至少提供一个字段（包括嵌套的 address/document 字段）。

{
  "data": {
    "full_name": "string",
    "country_of_birth": "string",
    "date_of_birth": "yyyy-mm-dd",
    "address": {
      "city": "string",
      "country": "string",
      "address_line_1": "string",
      "number": "string",
      "zip_code": "string"
    },
    "document": {
      "id_nationality": "string",
      "id_type": "string",
      "id_number": "string"
    },
    "occupation": "string",
    "phone_number": "string",
    "email": "string",
    "gender": "string"
  }
}

对 Evidence Requests 执行的操作

🔍 Retrieval

📄 Get by ID

⬆️ Upload Documents

⬇️ Download Documents

📨 Submit Information

描述： 使用状态、创建日期、更新日期等筛选条件搜索并检索 Evidence Requests。

操作后预期结果：
返回分页的 Evidence Request 对象列表，包含状态、截止日期及所需证据信息。

📘 了解更多： 🔗 获取所有 Evidence Requests

Evidence Request 对象

Evidence Request 代表一个合规或风险调查案例。

关键属性

字段	描述
`id`	Evidence Request 的唯一标识符
`reference_id`	外部参考（案例、交易、流程）
`expiration_date`	提交证据的截止日期
`status`	`INITIATED`、`PENDING_INFORMATION`、`COMPLETED`
`evidence_requested`	所需的文件和信息
`evidence_documents`	已上传的文件
`evidence_information`	已提交的结构化信息
`created_at`	创建时间戳
`updated_at`	最后更新时间戳

如何开始

Subscribe to evidence request notifications

使用 Notifications & Subscriptions API 订阅 evidence-request.ask 事件。

Receive and parse the webhook

从 Webhook 载荷中获取 evidence_request_id、上下文及所需证据信息。

Upload requested documents

生成上传 URL 并安全上传所请求的文件。

Submit required information

使用提交接口提供结构化信息。

Monitor request completion

检索 Evidence Request 以核验其最终状态。

使用此 API 后的预期效果

Regulatory compliance readiness

高效响应合规及欺诈相关的证据请求。

Secure evidence handling

确保敏感信息通过签名 URL 和结构化结构进行传输。

Operational transparency

保留 Evidence Requests 及提交记录的完整审计跟踪。

Cross-feature traceability

将 Evidence Requests 与资金流动、交易对手方及目标关联起来。

证据 API

创建 Evidence Requests（概念概述）#

Evidence Requests 生命周期#

Evidence Request 通知#

通知结构#

Evidence Request 上下文#

上下文字段#

证据类型目录#

信息结构#

对 Evidence Requests 执行的操作#

Evidence Request 对象#

关键属性#

如何开始#

使用此 API 后的预期效果#

创建 Evidence Requests（概念概述）

Evidence Requests 生命周期

Evidence Request 通知

通知结构

Evidence Request 上下文

上下文字段

证据类型目录

信息结构

对 Evidence Requests 执行的操作

Evidence Request 对象

关键属性

如何开始

使用此 API 后的预期效果