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!
Karina Mota
Field Software Engineer | VTEX