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

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

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

创建 Evidence Requests（概念概述）

Evidence Requests 由 Cobre 发起，并通过 Notifications & Subscriptions 推送给客户。
客户 不直接创建证据请求，而是通过提交所需文件和信息来响应请求。

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

evidence-request.ask

订阅后，每当新的证据请求被创建时，客户将收到一条 Webhook 通知。

Evidence Requests 生命周期

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

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

文件 → 使用签名 URL 上传

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

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

客户每条证据请求 只能提交一次。不允许重复提交。

Evidence Request 通知

客户在订阅 evidence-request.ask 后，将通过 Notifications API 接收证据请求。

通知结构

{
  "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 对象用于标识 触发证据请求的原因，帮助客户将其与内部系统进行关联。

上下文字段

字段	描述
`counterparty_id`	与请求关联的交易对手方
`mm_id`	触发请求的 Money Movement
`destination_id`	Destination 资源标识符
`destination_type`	目标标识符类型（如 RFC、NIT）
`destination_number`	目标识别编号
`destination_fullname`	目标全名
`destination_account_number`	目标账户号码
`destination_providers_id`	服务商专属目标标识符

并非每条请求都包含所有字段。上下文内容取决于触发证据请求的事件。

证据类型目录

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

Document Types

Information Types

文件类型	预期证据
`doc_funds`	资金证明及异常资金流动说明
`official_identification_copy`	政府颁发的身份证件（护照、驾照等）
`identification_and_address_copy`	政府颁发的身份证件及居住地址证明

信息结构

当请求的信息类型为 information_counterparty_id 时，必须提交以下结构化载荷：

{
  "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 Request 对象列表，包含状态、截止日期及所需证据信息。

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

Evidence Request 对象

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

核心属性

字段	描述
`id`	证据请求的唯一标识符
`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

检索证据请求以核验其最终状态。

使用此 API 后的预期效果

Regulatory compliance readiness

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

Secure evidence handling

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

Operational transparency

完整保留证据请求与提交的审计记录。

Cross-feature traceability

将证据请求与 Money Movements、Counterparties 及 Destinations 进行关联追溯。

Evidence 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 后的预期效果