---
title: Cardholder Verification
description: Capacidade que confirma que um cartão pertence ao seu titular declarado, reutilizando um processo previamente validado junto com o CPF e os dados do cartão da pessoa.
canonical: https://developer.unico.io/pt-BR/dual-api/capabilities/cardholder-verification
locale: pt-BR
generated_by: markdown-export
---

Cardholder Verification confirma que um cartão pertence ao seu titular declarado — inteiramente back-end, sem etapa de captura visual.

### O que faz

Confirma que o CPF e o cartão apresentado pertencem à mesma pessoa — uma verificação de titularidade card-not-present. Ela reutiliza um processo previamente validado (referenciado por seu id, `referenceProcessId`) junto com o CPF e os dados do cartão da pessoa (`bin`/`last4`) para responder à verificação diretamente, sem executar uma nova etapa de captura.

:::note[Não é o mesmo que Verificação de Cartão Não Presente]
Esta capacidade é uma superfície de integração diferente do produto [Verificação de Cartão Não Presente](/products/regional-solutions/card-not-present-verification/index).
:::

### Entradas

- O tipo de documento, enviado via `subject.duiType` (atualmente apenas `DUI_TYPE_BR_CPF`), e o valor do CPF via `subject.code`.
- `card`: `bin` (os primeiros 6 ou 8 dígitos do cartão) e `last4` (os últimos 4 dígitos); `name` é opcional.
- `referenceProcessId` — o id do processo previamente validado que está sendo reutilizado, no qual a identidade dessa pessoa já foi confirmada (Verificação de Identidade ou Prova de Vida). A versão atual desta capacidade é baseada em reutilização: sem esse campo, o gate nunca é disparado e a resposta assume por padrão o resultado `unsure` — a própria requisição nunca falha.
- Acionada via [`POST /processes/v1`](/dual-api/developers/api-reference/api/post-processes) com uma Recipe (API key) que inclui Cardholder Verification. Ela é habilitada por API key através da Recipe (ou `capabilities_enabled`), não pelo campo `flow`.

### Respostas possíveis

| Resposta | Significado |
|---|---|
| `approved` | O CPF e o cartão pertencem à mesma pessoa. |
| `unsure` | Ou não há um processo válido para reutilizar, ou a própria verificação foi inconclusiva. |
| _(omitido)_ | A verificação não foi concluída dentro da chamada síncrona. O campo `cardholderVerification` está ausente da resposta do [Get Process](/dual-api/developers/api-reference/api/get-process), e `status` reflete que o processo ainda está em processamento. |

### Disponibilidade

| Superfície | Suportado |
|---|:-:|
| **SDK** (Android, iOS, Flutter) | ❌ Capacidade exclusivamente back-end, sem etapa de captura |
| **Web** (iFrame, Redirect) | ❌ Capacidade exclusivamente back-end, sem etapa de captura |
| **API** (headless, sem SDK) | ✅ |

### Combinações válidas

Cardholder Verification não faz parte do catálogo de `flow` pré-composto — ela é habilitada diretamente na Recipe da API key (ou em `capabilities_enabled`, para chaves não-IDCloud), de forma independente dos fluxos em [Fluxos disponíveis](/dual-api/capabilities/available-flows).

### Casos de uso que utilizam esta capacidade

Ainda não há casos de uso publicados que referenciem esta capacidade.