Cartões de clientes e cobranças recorrentes no cartão
Os cartões são mantidos para que os clientes possam ser cobrados de acordo com o cronograma acordado — exibidos apenas pela marca e os quatro últimos dígitos, lacrados e descriptografados somente para a criação do arquivo para o banco.
Uma assinatura, uma mensalidade, um plano de parcelamento: o cliente concorda uma vez e a cobrança é feita de acordo com um cronograma. A área de Contabilidade → Pagamentos com Cartão integra as três partes — os cartões, os contratos de cobrança e os lotes enviados ao banco. Eles são estruturados de acordo com o padrão de segurança da indústria de cartões (PCI DSS), portanto, o número do cartão é a única informação no TRANXACT que ninguém consegue ler na tela.
Cartas
Ao adicionar um cartão, são necessários o cliente, o número do cartão, a data de validade, o nome impresso no cartão e o CEP de cobrança. A partir daí, o cartão é exibido apenas pela bandeira e pelos quatro últimos dígitos, em todos os lugares: na tela, nos downloads, no ASK e no histórico de auditoria.
- O número é selado: criptografado com uma chave própria (AES-256-GCM), e essa chave, por sua vez, é criptografada com uma chave de criptografia que a plataforma mantém fora do banco de dados. Uma instalação de produção sem essa chave se recusa a armazenar o cartão.
- O código de segurança (CVV ou CVC), o PIN e os dados da tarja magnética são recusados se forem enviados e nunca são armazenados.
- O mesmo cartão inserido duas vezes é reconhecido e mantido apenas uma vez.
- A opção Editar altera a data de validade, o nome no cartão, o CEP de cobrança ou o status — nunca o número. Um novo cartão é um novo cartão: adicione-o, transfira as autorizações para ele e, em seguida, exclua o antigo.
- A opção "Excluir" destrói a chave do cartão, impedindo que o número seja recuperado por qualquer pessoa, e cancela as autorizações associadas a ele.
obrigatoriedade do cartão
Uma autorização é o consentimento do cliente para que a cobrança seja efetuada: o cartão, o valor e a moeda, a frequência (única, mensal, trimestral ou anual), a data da primeira cobrança e, se houver, a data de término. O que o cliente concordou, palavra por palavra, é imprescindível — esse consentimento é a base para contestar uma cobrança. Uma autorização pode ser pausada, retomada ou cancelada.
lotes de cobrança de cartão
- A cobrança devida por mandato gera uma única cobrança para cada mandato vencido na data de execução, e nada mais: executar o mandato novamente para a mesma data não cobrará ninguém duas vezes.
- A exportação para o banco cria o arquivo que o adquirente ou o banco utiliza. É o único local onde um número de cartão é descriptografado, requer uma autorização própria (Exportação em Lote de Cartões) e cada exportação é registrada — sem os números dos cartões. Faça o upload do arquivo e, em seguida, exclua sua cópia.
- A resposta do banco é registrada para cada cobrança: liquidada ou rejeitada.
Quem pode fazer o quê?
Cartões, mandatos de cartão, lotes de cobrança de cartão, exportação de lotes de cartão e API de cartão (integrações externas) são todos concedidos em Plataforma → Funções e Autorizações, como qualquer outra tela. ASK e os agentes têm todas as rotas de cartão recusadas, independentemente da função que desempenham.
Cartões do seu site: a API de cartões
Um site ou aplicativo que aceita dados de cartão pode armazená-los por meio de uma API externa, de forma que o número nunca passe por uma pessoa.
| Chamar | O que faz |
|---|---|
| POST /api/accounting/card-api/v1/cards | Armazena um cartão. Envie um cabeçalho Idempotency-Key: a mesma chave enviada duas vezes armazena o cartão uma vez e retorna a mesma resposta. |
| GET /api/accounting/card-api/v1/cards | Os cartões, mascarados — marca e os quatro últimos. |
| PATCH …/cards/{id} | A data de validade, o nome impresso no cartão, o CEP de cobrança ou o status. Nunca o número. |
| EXCLUIR …/cards/{id} | Destrói o cartão, assim como a opção Excluir faz. |
| /api/contabilidade/api-cartão/v1/mandatos | Cria e lê mandatos, com uma chave de idempotência da mesma forma. |
- O usuário que faz a chamada inicia sessão com o token de uma conta de serviço (consulte Contas de serviço), e a função dessa conta de serviço precisa de uma permissão explícita na API de Cartões (integrações externas). Uma função com todos os privilégios ou uma função de administrador não são válidas: a permissão deve ser concedida nominalmente.
- Em produção, as chamadas são aceitas somente via HTTPS.
- As chamadas são limitadas por conta, e uma sequência de cartões recusados ou inválidos — o padrão de alguém testando números roubados — bloqueia o acesso do chamador.