Investigar a atividade das transações
Rastrear uma ordem desde a criação até a roteamento, autenticação, pagamento, captura, cancelamento ou reembolso no DEUNA Admin.
Nesta página
Utilize a atividade das transações quando uma ordem estiver pendente, rejeitada, atrasada ou apresentando comportamento diferente da integração com o comerciante. O DEUNA Admin combina um histórico de pagamentos em nível de negócios com registros de solicitações e respostas técnicas, permitindo que as equipes de operações e integração investiguem a mesma transação sem precisar alternar entre ferramentas.
A atividade das transações é somente leitura. Visualizar um evento não tenta novamente uma solicitação, alterar uma ordem ou entrar em contato com um processador de pagamento.
Antes de começar#
Seu papel deve incluir a Seção de Visualização de Pedidos autorização necessária. Confirme o comerciante e o ambiente selecionados antes de pesquisar; os registros são limitados a esse contexto.
Tenha pelo menos um identificador disponível:
- ID do pedido ou token de pedido
- Transaction ID
- Endereço de e-mail do cliente, quando permitido pela sua política de privacidade
- Data aproximada de criação
Se você não conseguir abrir Pagamentos > Pedidose solicite a um usuário Admin que revise seus papéis e permissões..
Escolha a visualização correta#
Os detalhes do pedido fornecem duas superfícies de investigação relacionadas. Comece com Visualizar histórico, e use Técnico quando precisar da troca subjacente.
| Superfície | Melhor para | O que é exibido |
|---|---|---|
| Visualizar histórico | Compreendendo o ciclo de vida do pagamento | Criação e atualizações de pedidos, criação e alterações de status de pagamento, roteamento, 3DS e eventos de fraude, com os campos relevantes para cada evento. |
| Técnico | Diagnosticar uma troca entre integração ou provedor | Eventos de transação registrados, método HTTP e destino, código de resposta, dados de solicitação e resposta, timestamps e identificadores disponíveis de solicitação, rastreamento e span. |
| Registros de Atividade | Rastreamento de ações realizadas por usuários de administrador | Quem alterou uma configuração ou executou uma ação de administrador. Os logs de atividade não representam o rastreamento da execução do pagamento. |
Acesse a atividade das transações#
- Faça login no DEUNA Admin.
- Selecione o comerciante e o ambiente associados à transação.
- Abra Pagamentos > Pedidos.
- Pesquise por ID do pedido ou e-mail, ou use os filtros de data e pagamento para refinar a lista.
- Abra o menu de ações de linha e selecione Ver detalhes.
- Para o resumo do ciclo de vida, selecione Visualizar histórico. Para a atividade das transações, abra Técnico.
Se o pedido não tiver eventos técnicos registrados, Técnico exibe Nenhuma atividade técnica. Isso não identifica automaticamente a causa ou o resultado do pagamento.
Acompanhe o histórico de pagamentos#
Selecione Visualizar histórico a partir do cabeçalho do detalhe do pedido. O histórico é apresentado como uma linha do tempo, com o evento mais recente primeiro.
Os campos exatos dependem do evento:
| Evento | Evidências que você pode encontrar |
|---|---|
| Pedido criado | Valor inicial, moeda e status do pedido. |
| Pedido atualizado | Status atual do pedido e do pagamento. |
| Pagamento criado | Valor e moeda do pagamento. |
| Status do pagamento atualizado | Status do pagamento e detalhes do processador, autorização, captura, reembolso ou erro aplicáveis. |
| Rota gerada | Regra e caminho aplicados, além do provedor de pagamento ou fraude representado por essa rota. Uma decisão de roteamento pode criar várias entradas na linha do tempo. |
| 3DS atualizado | Status de autenticação, provedor 3DS e um código ou mensagem de erro, caso ocorra algum. |
| Análise de fraude | Detalhes do provedor, decisão, risco, avaliação ou modo "shadow". |
Não considere um evento intermediário como o resultado financeiro final. Por exemplo, uma autenticação 3DS bem-sucedida permite a continuidade do processamento do pagamento, mas não significa que o pagamento foi autorizado ou capturado.
Inspeção de eventos técnicos#
Abra Técnico. Essa visualização possui duas áreas: Atividade e Dados.
Atividade técnica no DEUNA Admin. Todos os valores de lojista, usuário, provedor, identificador, tempo e payload deste exemplo são fictícios.
O que a visualização técnica contém
| Área | O que aparece lá | Como usar |
|---|---|---|
| Contexto da ordem | Valor total da ordem, status da ordem e pagamento, última atualização, token da ordem, ID da ordem e ID do cliente. | Verifique se abriu a ordem correta e o ambiente correto antes de interpretar um evento. |
| Controles de atividade | Contagem de eventos registrados, controle de ordenação, pesquisa por nome de evento e três modos de agrupamento: Nenhum, Requisição e Rastreamento. | Reduza um longo rastreamento de transação para os eventos relacionados à operação que você está investigando. |
| Cabeçalho de grupo | Tipo de grupo, ID de solicitação ou ID de rastreamento abreviado, número de eventos e a soma do tempo de execução registrado para os eventos nesse grupo. | Expanda ou dobre os pontos de verificação relacionados e compare uma solicitação ou rastreamento com outro. |
| Ponto de verificação de atividade | Ícone de código de resposta, nome do evento, hora de criação do evento e timestamp do log registrado. | Selecione o ponto de verificação que melhor corresponde à etapa falhada, atrasada ou inesperada. |
| Resumo da troca | Método HTTP ou protocolo, destino, ID de solicitação, ID de rastreamento e ID de Span. Os identificadores disponíveis incluem controles de cópia. | Correlacione o evento com logs do comerciante, evidências do provedor ou uma investigação de suporte da DEUNA. |
| Visualizador de dados | Abas de "Solicitação" e "Resposta", indicador de código de resposta, valor de tempo decorrido (quando disponível) e dados de carga formatados com controle de cópia. | Compare os dados de saída com o resultado retornado. Copie apenas as evidências mínimas e seguras necessárias. |
O visualizador de payload mantém os nomes de objetos e campos visíveis para que você possa inspecionar a estrutura da troca. Os valores e o aninhamento variam de acordo com o evento e o provedor. Um campo mostrado no exemplo não é garantido de aparecer em todas as transações.
Leia um evento
- selecionar um evento em Atividade. Em dispositivos móveis, expanda o evento.
- Verifique o nome e o timestamp do evento.
- Compare o método HTTP, o destino e o código de resposta com a operação esperada.
- Mude entre Solicitação e Resposta em Dados.
- Registre o ID da Solicitação, ID de Rastreamento ou ID de Span, quando estiverem presentes.
Quando um evento possui uma 4xx resposta, o Admin da DEUNA pode exibir um uma mensagem de erro acima do payload. Outros códigos de resposta permanecem visíveis no evento e no painel de dados.
O código de resposta descreve a troca técnica, e não necessariamente o resultado final do pagamento. Antes de processar um pedido, compare o código com Status do pagamento, Visualizar históricoe notificações de status assíncronas.
Eventos gerados durante o fluxo de um pedido
A atividade disponível depende do caminho que a transação seguiu. Grupos comuns incluem:
| Palco | Exemplos visíveis na Atividade | O que inspecionar |
|---|---|---|
| Pedido | Um novo pedido foi criado; o pedido foi atualizado | Identificadores de pedido e o status retornado à integração do comerciante. |
| Roteamento | Gere a roteamento de pagamento | o caminho selecionado e as trocas com o provedor que o seguem. |
| Pagamento | Gere o pagamento; solicite a autorização | o valor e a moeda, a resposta do processador e o status resultante do pagamento. |
| Autenticação | Avaliação 3DS iniciada, desafiada, atualizada, concluída ou falhou | Se a ação do cliente foi necessária e se o processamento do pagamento continuou posteriormente. |
| Verificação de endereço | Validação AVS, supressão ou reversão | resultado de validação normalizado e a ação de pagamento que seguiu. |
| Fraude | Gere a análise do motor de antifraude; avaliação "shadow" | resultado do provedor e se a transação prosseguiu para o processamento de pagamento ou revisão. |
| Operações pós-pagamento | Captura, captura parcial, reembolso, reembolso parcial, cancelamento, ou solicitação de reversão | o valor e o identificador da operação, a resposta e o evento de status de pagamento posterior que confirma o resultado. |
Alguns eventos registram que uma etapa ocorreu, mas não contêm o corpo da solicitação ou resposta. A disponibilidade do payload varia de acordo com a operação e o provedor.
Agrupe e procure no rastreamento#
Em AtividadeUtilize os controles a seguir para reduzir o rastreamento:
- Nenhum mostra cada evento em uma lista plana.
- Solicitação agrupa eventos que compartilham um ID de Solicitação. Use-o para acompanhar o trabalho iniciado por uma solicitação de entrada.
- Rastreamento agrupa eventos que compartilham um ID de Rastreamento. Use-o para acompanhar uma transação em etapas de processamento relacionadas.
- Pesquisar evento filtra por nome de evento exibido.
- Ordenar atividade inverte a ordem dos eventos.
Quando um evento não possui um valor para o identificador do grupo selecionado, o Admin da DEUNA o coloca em Órfão. O evento ainda pode ser útil se o ID da transação, o timestamp e os eventos vizinhos corresponderem à janela do incidente.
Investigue um pagamento ou transação com falha#
Siga esta ordem para não confundir um erro técnico intermediário com o resultado final:
- Confirme o ambiente, o status atual do pedido, o status de pagamento atual, Order IDe Transaction ID.
- Abra Visualizar histórico e identifique o último evento do ciclo de vida.
- Abra Técnico e agrupe por Rastreamento.
- Encontre o pagamento, roteamento, autenticação, fraude ou evento pós-pagamento correspondente.
- Compare o código de resposta e os dados de resposta com o próximo evento no rastreamento.
- Verifique se uma atualização de status posterior recuperou o pagamento, o moveu para outro provedor ou confirmou uma falha final.
- Compare o status final da DEUNA com o status recebido através do seu webhook de pagamento.
Para uma rejeição, procure na referência pública de códigos de erro usando o código de erro da DEUNA. Códigos e mensagens específicos do provedor devem ser interpretados com a documentação do provedor correspondente.
Prepare evidências para o suporte#
Quando precisar que a DEUNA forneça suporte, forneça as evidências mínimas necessárias:
- Comerciante e ambiente
- ID do pedido ou token de pedido
- Transaction ID
- Timestamp UTC e janela do incidente
- Nome do evento exibido e código de resposta
- ID da solicitação, ID de rastreamento e ID de Span, quando disponíveis
- Status atual do pedido e do pagamento
- Comportamento esperado e comportamento observado
Envie apenas o payload completo quando o Suporte solicitar através de um canal aprovado.
Limites e recuperação#
- A atividade da transação é um registro de observabilidade, não um controle de repetição ou reenvio.
- Nem todas as etapas produzem um corpo de solicitação e resposta.
- Os eventos podem chegar após a solicitação inicial quando um provedor reporta um resultado assíncrono.
- A ausência de atividade não estabelece se um provedor processou a transação.
- O status atual do pagamento ou do pedido é o snapshot administrativo; use webhooks e a resposta da API correspondente para o tratamento de estado no lado da integração.
Se os identificadores e o ambiente estiverem corretos, mas o evento necessário ainda estiver ausente, colete as evidências acima e entre em contato com o suporte da DEUNA. Não realize uma operação de pagamento até confirmar que é seguro tentar novamente.