Como verificar erros de transação dos seus pedidos

Neste artigo, você vai aprender como identificar e analisar erros de transação nos pedidos da plataforma, entendendo onde consultar as informações e como agir a partir de cada tipo de erro apresentado.

Quando utilizar este guia

Utilize este passo a passo sempre que:

• Um pedido não for finalizado corretamente;
• O pagamento constar como recusado, pendente ou com falha;
• Houver divergência entre o status do pedido e o status da transação;
• O cliente relatar erro no momento do pagamento.

Acessando os pedidos

1. No painel administrativo da plataforma, acesse o menu Pedidos.
2. Localize o pedido desejado utilizando os filtros disponíveis (ID do pedido, data, status ou cliente).
3. Clique sobre o pedido para acessar os detalhes.

Onde verificar os erros de transação

Dentro da tela de detalhes do pedido, siga os passos abaixo:

1. Acesse a seção Dados do Pagamento;
2. Localize o histórico de transações associadas ao pedido;
3. Clique na transação para visualizar os detalhes.

Nessa área, você encontrará informações importantes como:

• Bandeira do Cartão;
• Quantidade de Parcelas;
• Status do Pagamento;
• Dados do Pagamento;
• Mensagem de erro retornada pelo Gateway;
• Ícone de Olho com Detalhes da Transação.

Principais status de transação

Abaixo estão os status mais comuns que você pode encontrar:

• Aprovado: a transação foi concluída com sucesso.
• Recusado: o pagamento não foi autorizado pelo emissor ou gateway.
• Pendente: a transação está em análise ou aguardando confirmação.
• Erro: ocorreu uma falha durante o processamento.
• Cancelado: a transação foi cancelada manualmente ou automaticamente.

Como interpretar os códigos de erro

Os códigos e mensagens de erro são retornados diretamente pelo gateway de pagamento e ajudam a identificar o motivo exato da falha na transação.

Localizando o campo Response

Ao clicar no ícone de Detalhes (ícone de olho) dentro da transação do pedido, você terá acesso às informações técnicas retornadas pelo gateway. Nesse conteúdo, procure pelo campo Response (ou campos equivalentes, como code, text, descricao ou returnMessage).

Esse campo indica o motivo do cancelamento, recusa ou falha da transação.

Exemplos práticos de respostas

Abaixo estão alguns exemplos comuns que você pode encontrar:

Erro de dados inválidos na criação da transação

"response": "{\"sucesso\":false,\"mensagem\":\"Dados inválidos no response de transação\",\"detalhes\":[\"O campo 'ambiente' é obrigatório\",\"O campo 'transacao' é obrigatório\"]}"

➡ Indica falha na comunicação ou configuração entre a plataforma e o gateway.

Retorno inválido do gateway

"response": "{\"sucesso\":false,\"mensagem\":\"Retorno inválido do gateway\",\"detalhes\":[\"26 - Affiliation: Required parameter missing.\"]}"

➡ Geralmente relacionado a parâmetros obrigatórios não enviados ou credenciais incorretas.

Recusa por risco identificado pelo emissor

"code": 8,
"text": "negado",
"descricao": "Risco moderado identificado pelo emissor."

ou

"returnMessage": "Unauthorized. Identified moderate risk by the issuer."

➡ A transação foi recusada pelo banco emissor por critérios de risco.

Tipo de transação não permitido para o cartão

"code": 8,
"text": "negado",
"descricao": "Tipo de transação não permitido para este cartão."

➡ O cartão não permite o tipo de operação realizada (ex.: parcelamento, internacional, e-commerce).

Antifraude

• Caso utilize o antifraude nativo do gateway, verifique diretamente no painel do próprio gateway os detalhes da reprovação;
• Caso utilize um antifraude integrado, clique no ícone de detalhes da transação para visualizar a mensagem de reprovação retornada pelo antifraude.

Códigos de retorno dos gateways

A maioria dos gateways de pagamento identifica as mensagens de erro por meio de códigos de retorno, como:

• Mercado Pago;
• Pagar.me;
• e.Rede.

Em caso de dúvidas sobre o significado de um código específico:

1. Consulte a documentação oficial do seu gateway;
2. Verifique a descrição do código de retorno;
3. Se necessário, entre em contato com o suporte do gateway de pagamento para esclarecimentos.

Próximos passos após identificar o erro

Após identificar o erro de transação, recomendamos:

• Orientar o cliente a tentar novamente com outro meio de pagamento;
• Solicitar a verificação dos dados informados;
• Aguardar em casos de status Pendente, quando aplicável;
• Entrar em contato com o suporte do gateway de pagamento, se necessário.

Observações importantes

• Um pedido pode possuir mais de uma tentativa de transação;
• Nem todo erro está relacionado a instabilidade da plataforma;
• O gateway de pagamento é o responsável final pela autorização ou recusa das transações.

Dúvidas?

Acesse o Help Center da Uappi para mais conteúdos sobre a plataforma! Se ainda restarem dúvidas ou se o erro persistir, entre em contato com o nosso time de CS ou Suporte Técnico para análise.