Quais erros podem apresentar no processamento do cartão de crédito?
Visão geral
Este conteúdo detalha os principais erros que podem apresentar no processamento do cartão de crédito, focando em fornecer uma orientação clara e prática para a execução correta da rotina e identificação de falhas de transação no sistema Superlógica Imobi.
Quando usar este artigo
Utilize este guia sempre que houver necessidade de analisar quais erros podem apresentar no processamento do cartão de crédito ou quando encontrar dúvidas sobre as regras de negócio associadas a este procedimento de recebimento de aluguel e encargos de locação.
Sintoma ou cenário
O locatário tenta realizar o pagamento da sua fatura mensal de aluguel via cartão de crédito e a transação é recusada, gerando um código de erro de status (400, 401, 502 ou 503) no gateway de pagamento integrado.
Benefício para o usuário ou operação
Padronização do processo de auditoria de recebíveis.
Redução de erros manuais na análise de transações negadas.
Maior agilidade e autonomia na gestão de locações imobiliárias.
Onde acessar / contexto de uso
Acesse o sistema com suas credenciais e navegue até a ficha financeira do contrato do locatário ou diretamente no menu de Receitas > Receitas a Receber.
Pré-requisitos (Antes de começar)
Perfil Exato: É necessário possuir permissões de consulta ou gestão no módulo financeiro (Contas a Receber).
Recursos Sistêmicos: Módulo de recebimento por cartão de crédito ativo no plano contratado via gateway integrado (como o PJBank).
Insumos e Dados Técnicos: Informações completas sobre o contrato de locação, dados do locatário ou token de pagamento a ser analisado.
Causas prováveis
Dados do cartão digitados incorretamente pelo inquilino, falta de limite de crédito disponível, bloqueio preventivo de segurança do banco emissor ou falha de autenticação de credenciais da conta.
Como fazer ou corrigir
Durante o processamento de pagamentos por cartão de crédito, diferentes erros podem ocorrer, classificados por códigos de status que auxiliam na identificação e resolução. Abaixo está uma lista dos erros mais comuns e suas respectivas descrições, para facilitar o entendimento e a resolução de problemas. Para localizar o erro específico que você visualizou, use a busca do navegador (Ctrl + F) e insira o termo desejado:
Status 400 (Erro na solicitação)
Credencial não localizada;
Cartão inválido;
Token do cartão inválido;
Token do cliente não encontrado;
Mês inválido;
Ano inválido;
CPF/CNPJ inválido;
Email inválido;
Celular inválido;
Formato do CVV deve ser 999;
Valor inválido;
Número de parcelas inválido;
Nome do portador do cartão inválido;
Descrição do pagamento inválida;
Email excedeu o limite de 80 caracteres.
Status 401 (Autenticação necessária)
Credenciais inválidas;
Credencial não informada;
Status 502 (Erro do gateway)
Transação negada pelo emissor do cartão: Cartão com restrição;
Cartão inválido (15);
Cartão expirado: Troque o cartão e tente novamente;
Transação negada: Cartão de débito não aceito (39);
Senha incorreta (55);
Transação negada por suspeita de fraude: Consulte o emissor do cartão (67);
Violação de segurança: Tente novamente ou use um novo cartão (erro provável no CVV) (63).
Status 503 (Serviço indisponível)
Cartão inválido (14);
Código de segurança inválido (08);
Erro ao transacionar: Consulte o emissor do cartão (06);
Este cartão não pode ser usado para esta transação: Consulte o emissor;
Problema com o número do cartão: Consulte o emissor do cartão (09);
O banco emissor não reconhece os detalhes da transação: Verifique as informações e tente novamente mais tarde (30);
Emissor ou bandeira do cartão não aceito pela adquirente (31);
Emissor não permite este tipo de transação (40);
Resposta inválida (20);
Saldo insuficiente;
Transação duplicada: Entre em contato com o estabelecimento (94);
Transação negada: Consulte o emissor do cartão;
Verifique se o cartão está liberado para esta transação (05);
Transação negada por suspeita de fraude: Consulte o emissor do cartão;
Transação negada: Consulte o estabelecimento para mais detalhes (03);
Transação negada: Tente novamente mais tarde;
Valor inválido (13).
Resultado esperado
Ao concluir os passos, o sistema processará a solicitação de mapeamento de erros no processamento de cartão com sucesso. Você visualizará a linha do tempo de tentativas de cobrança atualizada com o respectivo status do gateway, permitindo orientar o locatário com total clareza contábil.
Quando escalar
Caso o gateway retorne falhas críticas generalizadas (erros internos de servidor 500 do sistema) que impeçam a abertura da tela de checkout ou impossibilitem a captura e salvamento do token de pagamento no ERP.
Informações que devem ser reunidas antes do escalonamento
Print completo da tela financeira exibindo o código de status retornado.
ID do locatário ou número do contrato de locação afetado.
Data e hora exata do ocorrido.
Regras importantes / Observações
- Em caso de erro, verifique diretamente com o emissor do cartão, especialmente para inconsistências que indicam restrições do portador ou suspeita de fraude.
- Erros de autenticação e dados incorretos geralmente são resolvidos revisando e corrigindo as informações de preenchimento cadastral.
- Recebimentos validados via cartão de crédito seguem a esteira padrão de prazos e taxas pactuadas para a composição das contas correntes.
- Mantenha os dados sempre atualizados para evitar inconsistências em relatórios futuros.
Problemas comuns e como resolver
- Problema: O aluguel foi pago pelo cartão com sucesso, mas o repasse automático via split de pagamentos não foi gerado na conta do proprietário.
Causa provável: Em contratos com a modalidade de Aluguel Garantido ativa, o recurso de split automático pelo adquirente (PJBank) funciona estritamente até a data de vencimento do título. Se o inquilino pagar com atraso no cartão, o split é cancelado e o dinheiro cai integralmente na conta da imobiliária, pois a responsabilidade pelo repasse ao locador já havia sido assumida pela administradora.
Ação recomendada: Realize a conferência manual da movimentação de conta corrente do proprietário e execute o lançamento do repasse de forma avulsa no financeiro corporativo (Despesas > A Pagar).
Dúvidas relacionadas
P: Como o recebimento por cartão de crédito impacta a emissão automática da Nota Fiscal de comissão? R: Por padrão, o sistema está parametrizado para gerar a nota fiscal de taxa de administração após realizar o repasse ao proprietário. No entanto, através da engrenagem de configurações, é possível alterar para a modalidade por período, fazendo com que o documento de comissão da imobiliária seja gerado com base na receita recebida dentro do mês, independentemente da data de transferência ao locador.
P: Lançamentos avulsos de despesas do proprietário podem ser cobrados diretamente no checkout de cartão do inquilino? R: Não. Movimentações avulsas de débito ou crédito (como o pagamento de um boleto de condomínio de um imóvel vago ou custos particulares de IPTU de responsabilidade do locador) não são feitas na tela de repasse ou cobrança do inquilino; elas devem ser obrigatoriamente lançadas acessando a seção de movimentações dentro do perfil do proprietário.
Palavras-chave de busca
transação recusada gateway, split de pagamentos vencido, aluguel garantido, erro de checkout cartão, conta corrente proprietário