Cardholder Verification

Cardholder Verification confirma que una tarjeta pertenece a su titular declarado — completamente back-end, sin paso de captura visual.

Qué hace

Confirma que el CPF y la tarjeta presentada pertenecen a la misma persona — una verificación de titularidad sin tarjeta presente (card-not-present). Reutiliza un proceso previamente validado (referenciado por su id, referenceProcessId) junto con el CPF y los datos de la tarjeta de la persona (bin/last4) para responder la verificación directamente, sin ejecutar un nuevo paso de captura.

No es lo mismo que Verificación de Tarjeta No Presente

Esta capacidad es una superficie de integración diferente del producto Verificación de Tarjeta No Presente.

Entradas

• El tipo de documento, enviado mediante subject.duiType (actualmente solo DUI_TYPE_BR_CPF), y el valor del CPF mediante subject.code.
• card: bin (los primeros 6 u 8 dígitos de la tarjeta) y last4 (los últimos 4 dígitos), name es opcional.
• referenceProcessId — el id del proceso previamente validado que se reutiliza, donde la identidad de esta persona ya fue confirmada (Verificación de Identidad o Detección de Vida). La versión actual de esta capacidad se basa en la reutilización: sin este campo, la validación nunca se activa y la respuesta usa por defecto el resultado estándar unsure — la solicitud en sí nunca falla.
• Se activa mediante POST /processes/v1 con una Recipe (clave de API) que incluye Cardholder Verification. Se habilita por clave de API a través de la Recipe (o capabilities_enabled), no a través del campo flow.

Respuestas posibles

Respuesta	Significado
approved	El CPF y la tarjeta pertenecen a la misma persona.
unsure	O no hay un proceso válido para reutilizar, o la verificación en sí fue inconclusa.
(omitido)	La verificación no concluyó dentro de la llamada sincrónica. El campo cardholderVerification está ausente de la respuesta de Obtener proceso, y status refleja que el proceso todavía se está procesando.

Disponibilidad

Superficie	Compatible
SDK (Android, iOS, Flutter)	❌ Capacidad solo de backend, sin paso de captura
Web (iFrame, Redirect)	❌ Capacidad solo de backend, sin paso de captura
API (headless, sin SDK)	✅

Combinaciones válidas

Cardholder Verification no forma parte del catálogo precompuesto de flow — se habilita directamente en la Recipe de la clave de API (o capabilities_enabled, para claves que no son de IDCloud), independientemente de los flujos en Flujos disponibles.

Casos de uso que utilizan esta capacidad

Aún no hay casos de uso publicados que hagan referencia a esta capacidad.