Fluxo Completo de Cadastro do Cartão de Crédito

Este artigo detalha todo o fluxo de cadastro e validação do cartão de crédito, desde o início do processo pelo condômino até os possíveis cenários de cartão validado ou invalidado.

1. Início do processo

O processo começa quando o condômino recebe um e-mail com o link para ativar o pagamento automático do condomínio por cartão de crédito.

Ao acessar esse link, o condômino encontra uma página pública de cadastro com:

Identificação do condomínio;
Campos de e-mail e CPF;
Campos do cartão;
Seleção das combinações de Unidade + Conta.

2. Validação de identificação

Antes do envio, o fluxo exige validações de identificação:

E-mail informado;
CPF válido;
E-mail validado via ação específica no formulário;
Seleção de pelo menos uma combinação de Unidade + Conta;

O sistema também consulta as unidades relacionadas ao e-mail e monta dinamicamente as combinações possíveis com as contas habilitadas para cartão de crédito.

3. Validação dos dados do cartão

Os dados do cartão passam por validações no front-end antes da tokenização:

Nome impresso no cartão com mínimo de 5 caracteres;
Pelo menos 2 palavras no nome;
Sem caracteres especiais no nome;
Número do cartão com validação por Luhn;
Bandeira identificada automaticamente;
Validade em formato MM/AAAA;
CVV válido;

Observação 1: Como o mesmo condomínio pode ter mais de uma conta apta para cartão de crédito, o sistema tokeniza o cartão separadamente para cada conta selecionada.

Observação 2: Quando já existe uma tentativa anterior com cartão invalidado para a mesma unidade, conta e e-mail, o sistema mantem o mesmo registro. Isso é importante para preservar o histórico e não misturar tentativas inválidas com tentativas posteriores.

4. E-mails enviados durante o processo

O fluxo pode enviar os seguintes e-mails:

E-mail de convite: Enviado antes do cadastro, com o link para iniciar o processo.
E-mail de confirmação do cadastro: Enviado logo após a criação do registro do cartão, informando que o processo seguirá para validação. Esse e-mail também explica que será feita uma cobrança simbólica de validação e que, em caso de autorização, o estorno será realizado.
E-mail de validação com sucesso: Enviado quando A cobrança de validação é autorizada e o estorno é concluído com sucesso.
E-mail de validação com falha: Enviado quando a validação não é autorizada ou falha tecnicamente de forma que o cartão não possa ser usado.

5. Validação com cobrança simbólica

Após o cadastro, o sistema executa uma validação real do cartão por meio de uma cobrança simbólica, hoje entre R$ 1,00 e R$ 2,00.

Se a cobrança for autorizada

O cartão é marcado como válido;
O sistema tenta realizar o estorno;
Se o estorno for concluído, o fluxo segue normalmente;
O condômino recebe e-mail de sucesso.

Se a cobrança não for autorizada

O cartão é marcado como inválido;
O condômino recebe e-mail informando a falha;
O cartão não entra no fluxo recorrente.

Se houver falha técnica

O cartão pode ir para status de erro;
O histórico registra a tentativa;
O fluxo não considera o cartão pronto para uso recorrente.

Boas práticas operacionais

Confirmar se a conta do condomínio está habilitada para cartão de crédito antes de iniciar o processo.
Monitorar os e-mails de sucesso e falha.
Em caso de cartão invalidado, orientar o condômino a repetir o processo com novo cartão.
Consultar o histórico interno para entender se a falha foi de autorização, estorno ou erro técnico.