Central de Ajuda

Leitura de 4 min

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

Introdução

Este documento tem o objetivo de orientar sobre a ocorrência e resolução de erros durante o processamento de pagamentos com cartão de crédito na integração com a Yapay. Em geral, essas falhas estão relacionadas a problemas de configuração ou instabilidades na comunicação com a plataforma de pagamento.

Acesso ao formulário

Caminho: Menu Sistema > Receber > Contas a Receber

Causa do erro

Os erros ao processar pagamentos com cartão de crédito pela Yapay podem ocorrer por diversos fatores, entre eles:

  • Credenciais de integração inválidas ou desatualizadas
  • Erros na comunicação com os servidores da Yapay
  • Configurações incorretas na carteira ou no meio de pagamento
  • Transação recusada pela operadora do cartão
  • Saldo insuficiente ou limite excedido no cartão do cliente
  • Informações incorretas inseridas no formulário de pagamento

Solução do erro

Para corrigir erros no pagamento com cartão Yapay:

  1. Verifique se as credenciais de integração estão corretas e atualizadas
  2. Teste a conexão com a API da Yapay
  3. Revise as configurações da carteira de cobrança vinculada ao cliente
  4. Confirme com o cliente se o cartão possui saldo disponível ou não foi recusado pelo emissor
  5. Verifique com atenção os dados inseridos no pagamento (nome, número do cartão, validade, CVV)
  6. Se necessário, peça ao cliente que tente novamente com outro cartão

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

  1. Acesse o menu Sistema > Receber > Contas a Receber

  2. Localize o título com erro e clique em Editar

  3. Vá até a aba Log Gateway

  4. Localize o log com o status de requisição = falha, selecione-o e clique em Visualizar

  5. Na tela de visualização do log, identifique no campo Dados o conteúdo retornado pela API

  6. Localize o campo:

    payment_response_code;s:2:122

    Esse retorno indica o número do código de erro.

  7. Acesse a seguinte documentação para consultar esse código:

  8. Na tabela, identifique:

    • O significado do código de erro
    • A descrição detalhada
    • A ação recomendada como solução

Exemplo:

  • Código retornado: 122
  • Descrição: NÚMERO CARTÃO NÃO PERTENCE AO EMISSOR
  • Ação: VERIFIQUE OS DADOS DO CARTAO [ECOM-122]

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 payment_response_code]  
    H --> I{Consultar o código?}  
    I --> J[Sim - Consulte na Tabela de Erros]  
    J --> K[Verifique descrição e ação recomendada]  
    K --> L[Execute a ação indicada]  
    L --> M[Fim]

Finalizado!

Com esse procedimento, você poderá identificar e corrigir possíveis falhas nos pagamentos com cartão de crédito realizados via integração Yapay.

Considerações finais

Falhas na transação com cartão de crédito são comuns e podem ocorrer por motivos variados, desde erros de digitação até recusas por parte da operadora. Monitorar e interpretar corretamente os códigos de erro é essencial para manter a operação fluida.

Mantenha sempre atualizadas as credenciais da integração, verifique a estabilidade dos serviços da Yapay e, em caso de recorrência nos erros ou códigos não mapeados, entre em contato com o suporte técnico ou com a equipe responsável da Yapay/Vindi para uma análise mais aprofundada.

Etiquetas

IntegracaoFinanceira Yapay PagamentosOnline CartaoDeCredito APIYapay Recorrencia ErroYapay LogGateway ReturnCode Vindi

Leia Também

Explore nossos produtos!

IXC ACS
Opa! Suite
IXC ONER
Olli

Páginas relacionadas