TRANXACT.AI Ajuda

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.

ChamarO que faz
POST /api/accounting/card-api/v1/cardsArmazena 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/cardsOs 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/mandatosCria 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.