Cartões e cobrança recorrente
Onde: os cartões ficam na ficha da pessoa — Cadastros → Pessoas → abra o responsável → aba de cartões (a aba só aparece para responsáveis já salvos). A opção de cobrança no cartão fica na matrícula do aluno.
Quem pode usar: usuários administrativos com acesso a "Cartões de Crédito" (concedido em Usuários e permissões).
Para que serve
Permite guardar cartões de crédito dos responsáveis de forma segura para duas finalidades:
- Baixa manual no cartão — em Contas a Receber, a forma de pagamento "Cartão de Crédito" cobra um cartão salvo na hora.
- Cobrança recorrente — o sistema cobra automaticamente as mensalidades no cartão, todo mês, no dia escolhido.
Cadastro do cartão
| Campo | O que é | Obrigatório | Observações |
|---|---|---|---|
| Número do Cartão | Número completo do cartão | Sim | |
| Nome do Portador | Nome impresso no cartão | Sim | Até 50 caracteres |
| Mês Validade | Mês de validade (2 dígitos) | Sim | |
| Ano Validade | Ano de validade (4 dígitos) | Sim | Não pode estar vencido |
| Código de Segurança (CVV) | Código de 3 ou 4 dígitos | Sim |
A lista de cartões mostra: número mascarado (só os primeiros e últimos 4 dígitos), bandeira, validade, portador e os indicadores ativo/verificado/padrão/válido.
:::info Regra do sistema
- O cartão é tokenizado no gateway de pagamento: o número completo e o CVV não ficam guardados no sistema — apenas os 4 primeiros e 4 últimos dígitos, para identificação.
- O cartão mais recente vira o padrão do responsável automaticamente.
- Mensagens de validação reais: "Informe o Mês de Validade do Cartão", "Mês de Validade do Cartão inválido", "Ano de Validade do Cartão inválido".
:::
Cobrança recorrente no cartão
Para colocar um aluno na cobrança automática:
- Cadastre o cartão do responsável (acima).
- Na matrícula do aluno, defina a forma de pagamento como Cartão de Crédito, selecione o cartão e informe o Dia de cobrança no cartão (1 a 31).
A partir daí, o sistema executa a rotina de cobrança todos os dias às 8h da manhã: no dia de cobrança de cada matrícula, ele cobra no cartão as mensalidades pendentes do período. Se a cobrança falha no gateway, a tentativa fica registrada na cobrança (em "Tentativas de pagamento") e o título continua pendente.
:::info Regra do sistema
- Pré-requisito: a cobrança recorrente precisa estar habilitada na instalação (configuração técnica feita pelo suporte). Quando desligada, a rotina roda mas não cobra ninguém.
- Cobranças de serviços escolares avulsos (declarações, 2ª via etc.) não entram na recorrência — o responsável paga pelo link da solicitação.
- O cartão de crédito também precisa estar habilitado nas Configurações de pagamento.
:::
Problemas comuns
- A mensalidade não foi cobrada no cartão — confira, nesta ordem: a matrícula está com forma de pagamento Cartão de Crédito, com cartão selecionado e dia de cobrança preenchido? O cartão está válido (não vencido)? A recorrência está habilitada na instalação? Havia mensalidade pendente no período?
- Cartão recusado — a recusa do gateway aparece no detalhe da cobrança, na linha da transação (motivo informado pelo gateway). Peça ao responsável um cartão alternativo ou envie o link de pagamento.
- Trocar o cartão da recorrência — cadastre o cartão novo na ficha do responsável e selecione-o na matrícula.