Como o sistema se comporta com cada tipo de erro em tentativas de cobrança por cartão

Visão geral

As tentativas de cobrança por cartão de crédito geram respostas automáticas das adquirentes e operadoras de cartão. O sistema interpreta esses códigos de retorno para definir se realizará novas tentativas de débito, se interromperá o processamento imediatamente ou se acionará a emissão de boleto bancário conforme a régua de cobrança.

Quando usar este artigo

Utilize este artigo para compreender o fluxo de retentativas automáticas do sistema, identificar os impactos dos códigos de erro retornados pelas operadoras de cartão e entender quando um boleto bancário é gerado após transações recusadas.

Sintoma ou cenário

Uma cobrança por cartão de crédito foi recusada pela operadora e a equipe financeira precisa entender se o sistema fará novas tentativas automáticas, se interromperá a cobrança ou se emitirá um boleto bancário alternativo.

Benefício para o usuário ou operação

Entendimento do ciclo de vida e do comportamento automático em cobranças recusadas por cartão de crédito;
Eliminação de intervenções manuais desnecessárias em transações com retentativa automática em andamento;
Identificação clara de falhas permanentes que exigem a atualização cadastral dos dados de pagamento pelo cliente final.

Onde acessar / contexto de uso

A consulta ao status das transações e aos retornos da operadora de cartão de crédito é realizada no menu Receitas > Cobranças ou na aba financeira da ficha do cliente.

Pré-requisitos (Antes de começar)

Perfil Exato: Acesso Administrativo (1000), Cobranças - Consulta (1080) ou Configurações - Consulta (1060).
Recursos Sistêmicos: Módulo de Cartão de Crédito ativo na licença e régua de cobrança configurada.
Insumos e Dados Técnicos: Código de retorno da operadora de cartão, ID do cliente e ID da cobrança afetada.

Causas prováveis

A cobrança no cartão de crédito do cliente foi recusada pela adquirente/operadora durante o processamento do faturamento por motivos operacionais, falta de saldo, cartão expirado ou dados incorretos.

Como fazer ou corrigir

O comportamento do sistema diante de uma recusa no cartão de crédito depende da classificação técnica do código de erro retornado pela adquirente (forçável, não forçável ou falha permanente).

Erros que permitem forçar (forcar = true):
- Comportamento: O sistema mantém a cobrança no fluxo automático e agenda novas tentativas no mesmo cartão de crédito.
- Retentativas: As tentativas continuam sendo executadas durante o período configurado no sistema (padrão de 5 dias).
- Exemplos de códigos: 03, 05, 51 e 62.
- Resultado final: Caso todas as retentativas falhem até o fim do período, o sistema envia o boleto ao cliente, desde que essa opção esteja parametrizada na régua de cobrança.
Erros que não permitem forçar (forcar = false):
- Comportamento: O sistema interrompe imediatamente o fluxo de cobrança no cartão de crédito.
- Retentativas: Não é realizada nenhuma nova tentativa automática.
- Exemplos de códigos: 14 e 54.
- Resultado final: O processamento no cartão é cancelado de forma definitiva e não ocorre o envio automático de boleto bancário.
Falhas permanentes:
- Comportamento: O sistema classifica a cobrança como falha permanente.
- Retentativas: Não são executadas retentativas automáticas.
- Resultado final: O débito no cartão fica suspenso e o fluxo só é retomado após o cliente ou a equipe atualizar os dados do cartão de crédito no sistema.

Resultado esperado

A cobrança cumpre a rotina programada de acordo com o código de erro retornado, realizando retentativas temporárias no prazo estipulado, acionando a emissão de boleto ou aguardando a atualização cadastral do cartão.

Quando escalar

Escale o atendimento para o suporte técnico se o sistema não realizar as retentativas em transações classificadas como forçáveis (forcar = true), se emitir boleto indevidamente para erros não forçáveis ou se o retorno do gateway indicar falha na integração com a adquirente.

Informações que devem ser reunidas antes do escalonamento

Nome da licença;
ID do cliente afetado;
ID ou Nosso Número da cobrança;
Código numérico e descrição exata do erro retornado pela operadora do cartão.

Regras importantes / Observações

Códigos de erro forçáveis (forcar = true) autorizam novas tentativas automáticas dentro do período estipulado nas configurações da licença.
Erros não forçáveis (forcar = false) e falhas permanentes interrompem o ciclo de cobrança no cartão imediatamente.
A geração e o envio do boleto após falhas sucessivas no cartão dependem exclusivamente das regras ativas na régua de cobrança.
A consulta com o significado detalhado de cada código de retorno deve ser feita junto à operadora ou adquirente do cartão.

Problemas comuns e como resolver

Problema: A cobrança no cartão de crédito falhou, mas o boleto bancário não foi gerado automaticamente.
- Causa provável: O código de erro retornado pela operadora é do tipo não forçável (forcar = false), ou a régua de cobrança da licença não está parametrizada para enviar boleto após falhas no cartão.
- Ação recomendada: Identifique o código de erro no histórico da cobrança. Se for um erro forçável, revise os parâmetros da régua de cobrança no sistema para habilitar a emissão do boleto.
Problema: O sistema não realizou novas tentativas após o cartão ser recusado por saldo insuficiente (código 51).
- Causa provável: O parâmetro de dias para retentativa de processamento de cartão com falha está desativado ou zerado nas configurações.
- Ação recomendada: Acesse o menu de configurações de cobrança e certifique-se de que o prazo de retentativa (padrão de 5 dias) esteja configurado corretamente.

Dúvidas relacionadas

P: O sistema envia boleto bancário para qualquer tipo de erro retornado pelo cartão de crédito? R: Não, o envio de boleto ocorre apenas quando o erro permite retentativas (forcar = true), todas as tentativas dentro do prazo falham e a régua de cobrança está configurada para gerar o boleto.

P: Quantas tentativas o sistema realiza quando o erro do cartão é forçável (forcar = true)? R: O sistema executa tentativas diárias durante o prazo limite configurado na licença, cujo padrão é de 5 dias.

P: O que acontece quando ocorre um erro classificado como falha permanente no cartão? R: O sistema encerra as tentativas automáticas e o processamento só é retomado quando o cliente ou operador atualiza os dados do cartão de crédito.

Palavras-chave de busca

erros de cartão de crédito, retentativa de cobrança cartão, forcar true cartão, forcar false cartão, falha permanente cartão, envio de boleto falha cartão, código de erro adquirente