Cardholder Verification

Cardholder Verification 确认一张卡片属于其声明的持卡人——完全为后端流程，没有可视化采集步骤。

功能说明

确认所提供的 CPF 与出示的卡片属于同一人——一项无卡持有权检查。它通过重用先前已验证的流程（通过其 id，即 referenceProcessId 引用）以及该人的 CPF 和卡片数据（bin/last4），直接回答该检查，而无需运行新的采集步骤。

与无卡验证不同

此功能与无卡验证产品是不同的集成接口。

输入项

• 文档类型，通过 subject.duiType 发送（目前仅支持 DUI_TYPE_BR_CPF），以及通过 subject.code 发送的 CPF 值。
• card：bin（卡片的前 6 或 8 位数字）和 last4（后 4 位数字），name 为可选项。
• referenceProcessId —— 被重用的先前已验证流程的 id，该流程中此人的身份已得到确认（身份验证或活体检测）。该功能的当前版本基于重用机制：如果缺少此字段，触发条件永远不会满足，响应会默认返回标准的 unsure 结果——请求本身不会失败。
• 通过 POST /processes/v1 触发，使用包含 Cardholder Verification 的 Recipe（API key）。它是通过 Recipe（或 capabilities_enabled）按 API key 启用，而非通过 flow 字段。

可能的响应

响应	含义
approved	该 CPF 与该卡片属于同一人。
unsure	没有可重用的有效流程，或验证本身未能得出结论。
(省略)	验证未能在同步调用内完成。获取流程 响应中不包含 cardholderVerification 字段，status 显示该流程仍在处理中。

可用性

接入面	支持
SDK（Android、iOS、Flutter）	❌ 仅限后端的功能，无采集步骤
Web（iFrame、Redirect）	❌ 仅限后端的功能，无采集步骤
API（无头，无 SDK）	✅

有效组合

Cardholder Verification 不属于预先组合的 flow 目录——它是直接在 API key 的 Recipe（对于非 IDCloud key，为 capabilities_enabled）中启用的，与可用流程中的流程无关。

使用此功能的用例

目前还没有引用此功能的已发布用例。