# Verificação de Cartão

## O que é a verificação de cartão?

A verificação de cartão é um recurso de segurança que permite validar um cartão de crédito ou débito usando sua representação tokenizada. Esse processo confirma se o cartão é válido, ativo e não está sujeito a restrições como cancelamento, bloqueio ou expiração. Ao verificar os cartões antes de processar os pagamentos, você pode reduzir as falhas nas transações e melhorar a experiência geral de pagamento.

A verificação de cartão ajuda a confirmar a autenticidade do cartão sem manipular os dados brutos do cartão, o que aumenta a segurança e a conformidade com os requisitos do PCI DSS.

## Como a verificação de cartão funciona

O processo de verificação de cartão usa um número de cartão tokenizado junto com os detalhes do cartão — como bandeira, data de expiração e CVV — que correspondem aos dados originais fornecidos durante a tokenização. Ao enviar uma requisição de verificação, o sistema valida o status do cartão com o emissor do cartão sem processar um pagamento real.

É importante ressaltar que a verificação de cartão pode ser realizada com uma **autorização de valor zero** (**zero-amount authorization**), o que significa que nenhum fundo é retido ou deduzido do crédito disponível do portador do cartão. Isso oferece um benefício fundamental: a validação segura do cartão sem impactar o limite de crédito ou o saldo do portador do cartão, garantindo uma experiência contínua e não intrusiva.

## Casos de uso

A verificação de cartão é particularmente útil nos seguintes cenários:

  - **Antes de armazenar no Vault**: Valide um cartão antes de salvá-lo no Vault da Getnet para garantir que ele esteja ativo e válido.
  - **Validação pré-pagamento**: Verifique o status do cartão antes de iniciar um pagamento ou assinatura para reduzir as falhas nas transações.
  - **Prevenção proativa a fraudes**: Detecte cartões inválidos ou restritos com antecedência, reduzindo as transações negadas e melhorando as taxas de autorização.
  - **Onboarding de clientes**: Valide os cartões durante a configuração da conta ou o registro do método de pagamento.

## Disponibilidade regional

Para obter informações detalhadas sobre a disponibilidade da verificação de cartão por país, consulte [Core Cards - Card Verification](https://www.google.com/search?q=/en/products/online-payments/regional-api%3Fdoc%3Dreference-core-cards%23card-verification).

## Como realizar uma verificação de cartão

Para realizar uma verificação de cartão, você deve:

1.  **Tokenizar o cartão primeiro**: A requisição de verificação exige um número de cartão tokenizado (`number_token`), não os dados brutos do cartão. Você deve tokenizar o cartão usando o endpoint [Generate Token](https://www.google.com/search?q=/en/products/online-payments/regional-api/swagger%23tag/cards/post/dpm/cofre-gw-proxy/v1/tokens/card) antes da verificação. Para obter mais informações, consulte o guia [Criar um pagamento tokenizado](https://www.google.com/search?q=/en/products/online-payments/regional-api%3Fdoc%3Dcreate-a-tokenized-payment).

2.  **Fornecer os detalhes correspondentes do cartão**: Inclua as informações do cartão, como bandeira, data de expiração e CVV, que correspondam aos dados originais fornecidos durante a tokenização.

3.  **Incluir os cabeçalhos obrigatórios**: Certifique-se de que a sua requisição inclua os cabeçalhos de autenticação necessários e o seller ID.

Uma resposta de verificação bem-sucedida retorna os seguintes campos:

| Campo              | Descrição                                                      |
| :----------------- | :--------------------------------------------------------------- |
| **Verification ID** | Um identificador exclusivo para a transação de verificação             |
| **Authorization code** | Código de confirmação do emissor do cartão                          |
| **Transaction ID** | ID de referência para fins de rastreabilidade e auditoria                |

Esses identificadores podem ser registrados em seus sistemas para fins de rastreabilidade e auditoria.

## Veja também

Para obter detalhes de implementação e parâmetros de requisição, consulte o endpoint [Card verification](https://www.google.com/search?q=/en/products/online-payments/regional-api/swagger%23tag/cards/post/dpm/cofre-gw-proxy/v1/cards/verification) na especificação da API. Para entender como tokenizar cartões antes da verificação, consulte o guia [Criar um pagamento tokenizado](https://www.google.com/search?q=/en/products/online-payments/regional-api%3Fdoc%3Dcreate-a-tokenized-payment).