Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Painel
borderColor#2C004B
titleColor#FFF
titleBGColor#2C004B
borderStylesolid
titleSobre:

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.

Image Added

🔎 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:

  1. Identifique o status e o horário da tentativa.

  2. Confirme o meio de pagamento utilizado.

  3. Verifique o provedor e o gateway envolvidos.

  4. Analise as operações na ordem em que ocorreram.

  5. Consulte o código de retorno e a mensagem registrada.

  6. Em pagamentos Pix, verifique se houve acionamento de contingência.

  7. 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.

...