Dúvidas Frequentes: Pagamentos com cartão não estão funcionando | Erros nas transações com cartão de crédito | Como ler os logs das transações para identificar problemas de autorização?

Este tópico tem por objetivo fomentar o conhecimento do módulo de pagamentos da plataforma VTEX, tendo em vista que dúvidas como essas são comuns.

Sendo assim, antes de analisarmos o que ocorre neste tipo de caso, é importante entender como funciona o fluxo de pagamentos dentro da VTEX.
É importante ressaltar que nas transações, a VTEX depende da resposta do conector para prosseguir com o fluxo de pagamentos. A VTEX é 100% passiva em relação ao sucesso ou falha das etapas desse fluxo e o retorno do conector que determina se a transação pode ou não prosseguir para o próximo status.

Como esse processo funciona? Temos um artigo que vem mostrando de forma detalhada, vale a pena conferir:

Conforme consta no artigo citado acima, assim que o pedido é feito em uma loja VTEX, a transação entra com status de Authorizing, indicando que iniciou-se o processo de envio de informações para o conector de pagamentos. É nessa etapa que a VTEX envia a requisição de autorização.

O Gateway então é o responsável por fazer a análise e nos responder se a transação deve ser ou não autorizada (status Approved ou Denied ).

Caso seja um status Denied, é bem como a palavra informa em sua tradução, isso significa que essa transação foi negada e é então disparado o fluxo de cancelamento deste pedido.

Mas como checar isso na própria transação?

Para isso é necessário acessar o módulo de transações e clicar sobre a transação desejada:

Ao visualizar a página da transação, é possível verificar todos os logs e seus respectivos horários. Toda transação tendo o Cartão de Crédito como método de pagamento se inicia da seguinte maneira:

Logo após são enviados os dados da transação, como "orderId", "paymentMethod", "holder","documentType" "document" e outros, no seguinte log:

Observação: Caso você precise buscar algum campo específico basta utilizar o atalho Ctrl + F e buscar.

Logo após, recebemos então o retorno do conector de pagamentos, nos casos onde a transação é negada, temos algo semelhante ao registro de tela a seguir:

Algumas mensagens comuns nesses casos são:

"returnMessage":"Unauthorized. Insufficient funds."

"returnMessage":"Unauthorized. Please try again."

Ocorre que, independente da mensagem recebida como resposta do conector para a requisição feita no início da transação, nesses casos, o recomendado é checar com o parceiro o que pode ter ocorrido, pois a VTEX é 100% passiva no que tange ao fluxo de pagamentos, apenas recebemos a notificação do parceiro e alteramos o status da transação.

Caso ainda tenha alguma dúvida sobre o assunto, sinta-se à vontade para perguntar por aqui! :smiling_face:

Karina Mota
Field Software Engineer | VTEX

7 Likes

Oi @KarinaMota você consegue deixar um outro detalhe importante: o frontend não valida se o cartão é válido ou não na hora que o usuário digita lá no momento de finalizar a compra.

Obrigado.

1 Like

Oi @estevao_santos, na verdade, valida sim! Se o usuário digitar algum número incorretamente, o front-end exibe a seguinte mensagem:

Nesse caso, para gerar esse registro de tela eu inseri como dado inválido o Código de segurança do cartão.

Karina Mota
Field Software Engineer | VTEX

2 Likes

Oi @KarinaMota

Hmmm! Entendi. Eu sempre recebi a informação de que não validava. Então faz sentido atualizar para esse entendimento.

Obrigado.