Menu
Feedback
Comece aqui
Tutoriais
Portal do desenvolvedor

Problemas conhecidos
Diretivas de suporte
Troubleshooting

Perguntas frequentes
Comunicados
Tutoriais
Tutoriais
Explore tutoriais detalhados para operar sua loja VTEX.
Tutoriais
Pagamentos
Transações
Visualizar detalhes da transação em Pedidos
Visualizar detalhes da transação em Pedidos

O objetivo deste artigo é indicar o caminho para visualizar e analisar uma transação no módulo Pedidos.

Pedidos mostra todo o caminho percorrido por uma transação na sua loja. Com isso, nas interações, são exibidas as aprovações, os cancelamentos, o retorno do antifraude etc. Ou seja, todos os retornos dos sistemas de pagamento e antifraude estão logados no detalhe do pedido.

Para acessar essas informações, siga os passos abaixo.

  1. No Admin VTEX, acesse Pedidos > Transações, ou digite Transações na barra de busca no topo da página.
  2. Realize uma busca ou clique sobre a transação desejada.

Ao entrar na transação, você encontra duas caixas que contêm as principais informações referentes ao pagamento do pedido. Essas informações são atualizadas à medida que a transação avança no fluxo de pagamento do Pagamentos.

No lado direito há uma caixa que contém o valor total do pedido, os dados do cliente, o ID desse pedido e o número de identificação do Antifraude (caso exista na operação).

O ID é referente à transação no gateway da plataforma VTEX, e é inclusive parte da URL.

{"base64":"  ","img":{"width":1195,"height":458,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":77385,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/Payments/Transactions/como-visualizar-detalhes-do-pedido_1.png"}}

Acima dessa caixa, há um link para o pedido no módulo Pedidos.

Na caixa da esquerda, estão concentradas as informações relacionadas ao meio de pagamento.

Para tansações com cartão de crédito, cada pagamento (podem ser dois cartões) possui um ID gerado pela VTEX. A adquirente também cria uma, chamada Transaction ID (TID). A TID é específica para cada cartão, ou seja, se um pedido é pago com dois cartões, haverá duas transações e, logo, duas TIDs.

Em transações que não possuem TID, pode ser interpretado que a adquirente não processou o pagamento, isto é, que não possui TID. Ocasionalmente isso pode gerar um erro, e uma forma rápida de identificá-lo é verificar se existe uma TID.

A parte mais importante dessa tela é o log de interações da transação. Aqui fica registrada toda a comunicação da VTEX com os afiliados cadastrados – antifraude, gateways e adquirentes –, inclusive mensagens de sucesso e erro, com seus respectivos códigos.

Seguem abaixo exemplos de como visualizar os cenários mais comuns que necessitam análise no Pagamentos.

Exemplos

Cada caixa corresponde ao log contendo a resposta da interação entre a VTEX e o sistema parceiro. No topo da caixa aparece o nome do parceiro que gerou a mensagem.

Evento de aprovação

{"base64":"  ","img":{"width":1558,"height":901,"type":"jpg","mime":"image/jpeg","wUnits":"px","hUnits":"px","length":161644,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/Payments/Transactions/como-visualizar-detalhes-do-pedido_2.jpg"}}

Nesse exemplo, vemos a aprovação de um pagamento. Ou seja, vemos que a operadora autorizou o fechamento da compra com estes dados de pagamento.

Evento de aprovação de antifraude

{"base64":"  ","img":{"width":1535,"height":932,"type":"jpg","mime":"image/jpeg","wUnits":"px","hUnits":"px","length":165824,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/Payments/Transactions/como-visualizar-detalhes-do-pedido_3.jpg"}}

Neste exemplo, vemos o retorno do antifraude recebendo a transação e posteriormente o retorno com a análise de risco realizada, aprovando a mesma. Em casos de reprovação, o log exibirá a informação RiskRejected.

Evento de fatura

{"base64":"  ","img":{"width":1550,"height":887,"type":"jpg","mime":"image/jpeg","wUnits":"px","hUnits":"px","length":154703,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/Payments/Transactions/como-visualizar-detalhes-do-pedido_4.jpg"}}

Neste exemplo, a operadora retorna o evento de liquidação do valor, ou seja, informa que realizou a fatura do pedido.

Erro de processamento

O exemplo abaixo mostra uma transação de cartão de crédito que gerou erro ao ser processada pela adquirente Redecard. Os afiliados costumam retornar um código (ConnectorCode) junto a uma mensagem. Para encontrar informações detalhadas do erro, recomendamos consultar a documentação do adquirente. Por meio de uma rápida busca no Google é possível encontrar a lista de códigos e mensagens de cada afiliado.

{"base64":"  ","img":{"width":703,"height":535,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":41015,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/Payments/Transactions/como-visualizar-detalhes-do-pedido_5.png"}}

Liquidação automática agendada

A liquidação automática é uma funcionalidade que agenda a liquidação mesmo que a nota fiscal não tenha sido emitida. Portanto, é uma garantia da liquidação do valor, mesmo se não houve a fatura do pedido.

Caso o pedido seja cancelado, o estorno ocorrerá normalmente.

Veja como visualizar a data do agendamento da liquidação automática:

{"base64":"  ","img":{"width":1240,"height":666,"type":"jpg","mime":"image/jpeg","wUnits":"px","hUnits":"px","length":101215,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/Payments/Transactions/como-visualizar-detalhes-do-pedido_6.jpg"}}

TID de pagamento

TID de pagamento é o código que identifica a compra. Esse código não é gerado na VTEX, e sim enviado pela operadora no momento da autorização. Ou seja, a VTEX envia os dados do pedido e o gateway ou a operadora retorna o TID.

Essa informação é importante sempre que for necessário confirmar algo com a operadora, pois será necessário informar esse código a fim de identificar a transação.

Para encontrar esse código na transação, veja a ilustração abaixo.

{"base64":"  ","img":{"width":1238,"height":665,"type":"jpg","mime":"image/jpeg","wUnits":"px","hUnits":"px","length":96007,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/Payments/Transactions/como-visualizar-detalhes-do-pedido_7.jpg"}}

IP do cliente

O IP do cliente é coletado no momento da compra e pode ser visto no campo superior da tela da transação, conforme imagem abaixo.

{"base64":"  ","img":{"width":1238,"height":663,"type":"jpg","mime":"image/jpeg","wUnits":"px","hUnits":"px","length":91014,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/Payments/Transactions/como-visualizar-detalhes-do-pedido_8.jpg"}}

ID do antifraude

É o ID da transação para o antifraude. Para buscas no antifraude, deve-se consultar esse valor no PCI Gateway.

{"base64":"  ","img":{"width":1256,"height":556,"type":"gif","mime":"image/gif","wUnits":"px","hUnits":"px","length":46315,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/Payments/Transactions/como-visualizar-detalhes-do-pedido_9.gif"}}

Mais informações

Além das informações acima, existem outros dados retirados das interações com a operadora, com o gateway e/ou com o antifraude que são identificados e disponibilizados de forma mais clara no box + informações logo abaixo do topo de informações. Veja na imagem abaixo como visualizá-las:

{"base64":"  ","img":{"width":733,"height":663,"type":"jpg","mime":"image/jpeg","wUnits":"px","hUnits":"px","length":69874,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/Payments/Transactions/como-visualizar-detalhes-do-pedido_10.jpg"}}

Contribuidores
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Isso foi útil?
Sim
Não
Sugerir edições (GitHub)
Contribuidores
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Nesta página
Ainda tem dúvidas?
Pergunte à comunidade
Encontre soluções e compartilhe ideias na comunidade VTEX.
Junte-se à nossa comunidade
Solicite suporte à VTEX
Para assistência personalizada, entre em contato com nossos especialistas.
Abra um ticket de suporte
GithubDeveloper portalComunidadeFeedback