Passar para o conteúdo principal

Validar cartões cadastrados via API

Valide a titularidade do cartão antes de utilizá-lo em compras, pagamentos e cobranças recorrentes.

Escrito por Rachel

Importante
A funcionalidade está sendo disponibilizada de forma gradual.

Nesta primeira etapa, a validação de cartões está disponível apenas para integrações via API que utilizam o gateway VINDI.

Para que a validação funcione corretamente, podem ser necessárias configurações específicas na integração.

Ao cadastrar um cartão via API em uma filial com a funcionalidade habilitada, o cliente deve validar a titularidade do cartão antes que ele possa ser utilizado para compras, pagamentos ou cobranças recorrentes.


Introdução

A validação de cartões confirma que o cliente é o titular do cartão cadastrado. Esse processo reduz o risco de fraudes, uso indevido de cartões e chargebacks.

A validação é realizada por meio de uma pré-autorização, sem cobrança do valor ao cliente.


Como funciona

Após o cadastro do cartão via API:

  1. O EVO cria automaticamente uma pré-autorização no cartão.

  2. É enviado um valor aleatório de pequena denominação, conforme o país da academia.

  3. O cliente recebe um link para concluir a validação.

  4. O cliente deve consultar a movimentação do cartão e informar exatamente o valor da pré-autorização, incluindo os centavos.

  5. O cliente possui até 3 tentativas para informar o valor corretamente.

Enquanto a validação não for concluída, o cartão permanece com o status Pendente e não pode ser utilizado.


Faixa de valores da pré-autorização

País

Valor

Brasil

R$ 0,50 até R$ 3,00

México

MXN 15 até MXN 20

Peru

PEN 1 até PEN 5

Prazo para validação

O prazo para concluir a validação depende do tipo de cadastro:

  • Cliente: 24 horas.

  • Oportunidade: 5 minutos.

Resultado da validação

Se o valor informado estiver correto:

  • o cartão passa para o status Ativo;

  • fica disponível para compras;

  • pode ser utilizado em pagamentos;

  • pode ser utilizado em cobranças recorrentes.

Se o valor informado estiver incorreto ou o processo não for concluído dentro do prazo:

  • o cartão será removido do cadastro;

  • será necessário cadastrar um novo cartão para iniciar uma nova validação.

O que é uma pré-autorização

A pré-autorização é uma operação utilizada para verificar a validade do cartão e reservar temporariamente um valor, sem realizar sua cobrança.

Durante esse processo:

  • o limite disponível do cartão poderá ser reduzido temporariamente;

  • nenhum valor será debitado do cliente;

  • a autorização expirará automaticamente caso não seja capturada.

Como o processo de validação não realiza a captura da transação, o cliente não será cobrado.

Cadastro manual de cartões

Os cartões cadastrados manualmente no EVO por um colaborador da academia não passam pelo processo de validação.

Nesses casos:

  • nenhuma pré-autorização é realizada;

  • nenhum link de validação é enviado ao cliente;

  • o cartão é cadastrado diretamente com o status Ativo;

  • o cartão fica disponível imediatamente para compras, pagamentos e cobranças recorrentes.

Esse comportamento permite o cadastro de cartões que não possam ser validados por pré-autorização devido a limitações do gateway ou do emissor.

Finalização

Após a validação ser concluída com sucesso, o cartão fica com o status Ativo e pode ser utilizado normalmente nas operações do EVO.

Respondeu à sua pergunta?