Erro no pagamento com cartão de crédito Cielo

Introdução

Este guia fornece orientações detalhadas para identificar e corrigir erros que podem ocorrer durante o processamento de pagamentos com cartão de crédito integrados à plataforma da Cielo. Esses erros geralmente estão relacionados a configurações incorretas, falhas de comunicação com a API ou problemas na validação de transações pelo emissor do cartão.

Acesso ao Formulário

Caminho: Menu Sistema > Receber > Contas a Receber

---

Causa do erro

Os erros no processamento podem ocorrer por diversos motivos. Abaixo estão os mais comuns:

• Credenciais de Integração Inválidas: Tokens ou chaves de API incorretos ou vencidos.
• Problemas de Conexão: Instabilidade na comunicação entre o sistema e os servidores da Cielo.
• Configurações Incorretas: Falhas na configuração do meio de pagamento no sistema.
• Recusa do Cartão: Motivos como saldo insuficiente, cartão vencido, segurança, entre outros.
• Erro de Digitação: Dados do cartão inseridos incorretamente.

---

Solução do erro

Para corrigir erros no pagamento com cartão na integração com a Cielo, siga estas etapas:

1. Confirme se as credenciais da integração estão válidas e atualizadas.
2. Verifique se há falhas de conexão entre o sistema e a API da Cielo.
3. Analise se há inconsistências nas configurações da carteira ou meio de pagamento.
4. Confirme com o cliente se houve recusa por parte da operadora do cartão.
5. Certifique-se de que os dados do cartão inseridos estão corretos.
6. Verifique se o cartão possui limite/saldo suficiente para a transação.

---

Passo a passo - Correção do erro no pagamento com cartão de crédito Cielo

Através do contrato ou do cadastro financeiro do cliente:

1. Acesse a aba Financeiro.
2. Localize e selecione o título de cobrança com falha. Clique em Editar.
3. Vá até a aba Log Gateway.
4. Localize o log com Status de Requisição marcado como falha. Selecione-o e clique em Visualizar.
5. Na janela exibida, procure o campo Dados. O retorno da Cielo estará visível, e o código de erro aparecerá logo após a entrada returnCode.
   • Exemplo de retorno:

   returnCode;s:2:GT  
   

6. Registre o código exibido após “returnCode”.
7. Consulte as informações detalhadas do código em:
   • Tabela Interna de Erros Cielo
   • Tabela Externa de Erros Cielo (documentação oficial)
8. Verifique a coluna Ação para obter a orientação recomendada.
   • Exemplo para o código “GT”:

Ataque de força bruta.  
Ação: Transação não permitida. Entre em contato com a Cielo.

9. Siga a recomendação apresentada para corrigir o erro.
10. Fim.

---

Fluxo de trabalho

graph TD
    A[Início] --> B[Acesse a aba Financeiro]
    B --> C[Selecione o título de cobrança com problema e clique em Editar]
    C --> D[Acesse a aba Log Gateway]
    D --> E[Localize o log com Status de Requisição = Falha]
    E --> F[Clique em Visualizar]
    F --> G[Verifique o campo Dados]
    G --> H[Anote o código após returnCode]
    H --> I{Consultar código em tabela}
    I --> J[Consultar Tabela Interna]
    I --> K[Consultar Tabela Externa]
    J --> L[Verifique erro e ação recomendada]
    K --> L
    L --> M[Siga a orientação da tabela]
    M --> N[Fim]

---

Finalizado!

Após seguir este procedimento, você poderá identificar e corrigir a causa da falha no pagamento via API E-commerce da Cielo de forma mais segura e objetiva.

---

Considerações finais

Erros relacionados ao pagamento via cartão de crédito exigem atenção imediata, pois afetam diretamente o faturamento e a experiência do cliente. Identificar corretamente o código de erro e aplicar a solução indicada são etapas essenciais para manter a operação financeira fluida e com baixa taxa de falhas.

Mantenha as configurações de integração sempre atualizadas e monitore os logs de gateway regularmente para antecipar problemas. Caso necessário, entre em contato com o suporte da Cielo para esclarecimentos adicionais sobre códigos específicos não documentados.

Etiquetas

IntegracaoFinanceira Cielo PagamentosOnline CartaoDeCredito APICielo Recorrencia ErroCielo LogGateway ReturnCode Vindi

Leia Também

• Cielo - Cartão de Crédito
• Carteira de Cobrança
• Financeiro
• Integrações Bancárias - Carteira de Cobrança
• Recorrência com Cartão de Crédito
• Como o Cliente Ativa a Recorrência
• Como o Cliente Cancela a Recorrência
• Verificar Financeiro Recorrente com Cartão
• Relatório de Contratos em Recorrência
• Relatórios Financeiros
• Logs Gateway
• Como Reprocessar Logs Gateway
• Localizar Pagamentos - Logs Gateway
• Logs de Rotinas de Cobrança Gateway