Logs de transações de pagamento
A funcionalidade Logs de transações centraliza os registros das tentativas e operações de pagamento realizadas em pedidos e carrinhos abandonados.
Com essa visualização, é possível identificar recusas, falhas de comunicação, capturas, estornos, sincronizações, timeouts e acionamentos de contingência Pix com mais agilidade.
🔎 Visão geral
A área Logs de transações apresenta as informações técnicas geradas durante o processamento dos pagamentos.
Ela complementa a aba Pagamento:
A aba Pagamento apresenta o resumo financeiro e o status da transação.
A área Logs de transações reúne os eventos técnicos necessários para acompanhar e analisar o fluxo do pagamento.
As informações disponíveis podem variar conforme o meio de pagamento, o provedor utilizado e os dados retornados por cada integração.
📍 Onde acessar
Pedidos
Acesse:
Backoffice > Pedidos > selecione o pedido > Logs de transações
Utilize essa opção para consultar pagamentos e tentativas vinculadas a um pedido já criado.
Carrinhos abandonados
Acesse:
Backoffice > Carrinhos abandonados > selecione o carrinho > Logs de transações
Utilize essa opção para consultar tentativas realizadas durante o checkout, mesmo quando o pedido não tiver sido criado.
Como os registros são organizados
Os logs são apresentados em uma estrutura que ajuda a reconstruir o caminho percorrido pelo pagamento.
Meio de pagamento
Os registros são separados conforme o meio utilizado ou tentado, como:
Cartão de crédito
Cartão de débito
Pix
Boleto
Carteira digital
Vale ou benefício
Outros meios disponíveis na plataforma
Tentativa de pagamento
Cada nova tentativa realizada no mesmo pedido ou carrinho pode ser identificada separadamente.
Dessa forma, é possível diferenciar, por exemplo, uma tentativa recusada de uma nova tentativa posteriormente aprovada.
Provedor e gateway
A tela apresenta o provedor e o gateway responsáveis pelo processamento da operação, quando essas informações estiverem disponíveis.
Quando o provedor e o gateway forem diferentes, ambos poderão ser apresentados.
Operações
Dentro de cada tentativa, são exibidas as operações registradas durante o processamento, como:
Criação
Autorização
Captura
Consulta
Sincronização
Cancelamento
Estorno
Criação ou consulta de Pix
Acionamento de contingência Pix
Os nomes das operações podem variar conforme o provedor ou gateway utilizado.
Informações disponíveis
Em cada tentativa ou operação, a tela pode apresentar:
Data e hora do evento
Valor da operação
Status da operação
Meio de pagamento
Provedor e gateway utilizados
Identificador interno da transação
Identificador externo da transação
Número do gateway
NSU
Código de autorização
Requisição enviada
Resposta recebida
Código de retorno HTTP
Tempo de resposta
Mensagens de erro
Avisos e retornos técnicos
Identificadores utilizados para rastreabilidade
A apresentação dessas informações depende dos dados registrados e retornados por cada integração.
Consulta em carrinhos abandonados
A consulta dos logs não depende da criação de um pedido.
Quando uma tentativa de pagamento estiver vinculada ao carrinho, checkout, sessão ou outro identificador de rastreabilidade, os eventos registrados poderão ser consultados no detalhe do carrinho abandonado.
Essa visualização ajuda a investigar situações ocorridas antes da conclusão da compra, como:
Pagamento recusado
Erro de comunicação
Indisponibilidade do provedor
Timeout
Ausência de retorno
Erro técnico
Acionamento de contingência
Troca de provedor ou gateway
Contingência Pix
Quando o fluxo Pix utilizar contingência e os dados estiverem disponíveis, a tela identifica o caminho original e o caminho alternativo adotado para processar a tentativa.
A visualização pode apresentar:
Indicação de que a contingência estava ativa
Indicação de que a contingência foi acionada
Provedor ou gateway da tentativa original
Status da tentativa original
Provedor ou gateway utilizado na contingência
Status da tentativa em contingência
Data e hora do acionamento
Motivo do acionamento
Requisições e respostas registradas
Resultado final do pagamento
Essas informações facilitam a identificação de qual integração processou a tentativa e qual foi o resultado de cada etapa.
Mudança na aba Pagamento
A aba Pagamento permanece dedicada ao acompanhamento financeiro e transacional, apresentando informações como:
Status do pagamento
Forma de pagamento
Condição de pagamento
Valor do pedido ou carrinho
Total pago
Total pendente
Taxas
Total estornado
Dados resumidos da transação
Os detalhes técnicos das operações passam a ser consultados em Logs de transações.
Quando disponível, o atalho Ver logs da transação direciona o usuário para essa área.
🔒 Segurança e permissões
O acesso aos logs segue as permissões configuradas para pedidos, pagamentos e carrinhos abandonados.
O nível de detalhe apresentado pode variar conforme o perfil do usuário.
Dados sensíveis e credenciais não são exibidos de forma aberta. Informações como número completo do cartão, código de segurança, tokens, chaves, credenciais, cabeçalhos de autenticação e dados pessoais sensíveis são ocultadas ou mascaradas.
Quando não houver registros
Quando não existirem eventos associados ao pedido ou carrinho, será apresentada a seguinte mensagem:
Não há logs de transações disponíveis para este pedido ou carrinho.
Boas práticas de análise
Para analisar uma ocorrência de pagamento:
Identifique o status e o horário da tentativa.
Confirme o meio de pagamento utilizado.
Verifique o provedor e o gateway envolvidos.
Analise as operações na ordem em que ocorreram.
Consulte o código de retorno e a mensagem registrada.
Em pagamentos Pix, verifique se houve acionamento de contingência.
Ao solicitar apoio, informe os identificadores da transação e o horário do evento.
Não compartilhe dados sensíveis, credenciais ou informações completas de pagamento.
Observações
A disponibilidade e o nível de detalhe dos logs dependem das informações registradas por cada meio de pagamento, provedor e gateway.
Transações históricas podem apresentar menos informações do que as transações processadas após a disponibilização da funcionalidade.