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.