Getnet DocsGetnet Docs

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.

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 antes da verificação. Para obter mais informações, consulte o guia Criar um pagamento tokenizado.

  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:

CampoDescrição
Verification IDUm identificador exclusivo para a transação de verificação
Authorization codeCódigo de confirmação do emissor do cartão
Transaction IDID 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 na especificação da API. Para entender como tokenizar cartões antes da verificação, consulte o guia Criar um pagamento tokenizado.