Configurando a integração com VTEX

Esse guia tem como objetivo auxiliá-lo na inclusão da Konduto em sua loja VTEX.

De forma a facilitar e diminuir o esforço de configurações e detalhes necessários para essa integração, disponibilizamos esse guia com passos resumidos. 

A primeira parte dessa configuração refere-se à inclusão das meta tags em seu site. Abaixo detalharemos como você pode fazer isso através do GTM e posteriormente também, como configurar seu ambiente VTEX para uso da Konduto.

1. GTM (Google Tag Manager) e VTEX

Para utilizar a Konduto em seu site é mandatório que implemente o GTM disponibilizado pela VTEX em seu portal de ajuda. 

Acesse o link abaixo e siga o passo a passo de instalação:

Integração com o Google Tag Manager (VTEX)

Caso tenha alguma dúvida nesse processo, entre em contato com a equipe VTEX para auxiliá-lo(a).

2. Faça o backup do seu GTM

Antes de prosseguir com a importação do contêiner Konduto, realize o backup do conteúdo ja existente em seu GTM. Esse procedimento lhe dará uma garantia de poder retornar à versão anterior do seu GTM caso tenha algum imprevisto posterior.

Para isso, siga as orientações seguintes:

  • Com seu GTM aberto, clique em "Administrador":

  • Escolha o contêiner que deseja fazer o backup:

  • Clique em "Exportar contêiner" e guarde o arquivo:

3. Faça o download do contêiner da Konduto

Após concluir os passos indicados pela VTEX no link acima e o Backup, você precisa importar nosso contêiner em seu GTM fazendo o download no link abaixo.

http://download.konduto.com/GTM-KONDUTO-VTEX.json

Esse contêiner configurará de forma automática as demais telas no seu GTM que são necessárias para a utilização da Konduto com a VTEX.

Em geral essas configurações são extensas e buscando minimizar os procedimentos, pedimos que siga as instruções seguintes.

4. Importe o contêiner Konduto

  • Para importar o contêiner, na mesma tela da última configuração, clique em "Importar contêiner":

  • Na próxima tela, clique em "ESCOLHER ARQUIVO DE CONTÊINER" e selecione o arquivo enviado pela equipe Konduto:

  • Clique em "EXISTENTE":

  • Selecione a Área de Trabalho que irá utilizar clicando sobre ela:

  • Marque a opção "Combinar":

ATENÇÃO: atente-se para não selecionar a opção "Substituir". Se escolhida, a substituição certamente desconfigurará o seu GTM atual e você pode ter dificuldades em corrigir tais alterações.

  • Como pode ver na imagem abaixo, os boxes coloridos mostrarão o conteúdo que será mesclado. 

  • Dentro da opção "Combinar", marque a opção "Substituir acionadores, tags e variáveis em conflito.":

  • Clique em "Confirmar":

  • Clique em "Variáveis", no menu esquerdo:

b74afe43a02f8d35cb1cad436d18efef.png

  • Clique sobre "kondutoId":

d006e23aa27bc6eca5c3aeb3b1bd6380.png

  • Substitua a Chave destacada na imagem abaixo pela chave pública da Konduto. Essa chave pode ser encontrada dentro do Portal da Konduto.
    Para saber como localizá-la, clique aqui.

1b0fe3f251997b9d6a72232af6d7c93c.png

  • Clique em "Salvar" para finalizar as configurações

  • Clique em "Publicar" para finalizar a configuração:

5. Configure a afiliação de gateway na VTEX

Agora que o procedimento de inclusão das tags foi finalizado, você precisa configurar o ambiente VTEX com suas credenciais Konduto para utilizar no antifraude corretamente.

Siga as orientações abaixo:

  • Ao carregar janela de configurações, clique em "PCI":

  • Do lado superior direito, clique em "Configurações":

  • Após isso, clique em "Afiliações de Gateways"

  • Nessa mesma sessão, clique sobre o ícone verde representado pelo sinal "+" conforme indica a imagem abaixo:

  • Dentre os antifraudes listados, clique sobre "Konduto":

  • Esse é o lugar onde você adiciona as credenciais de acesso da Konduto para que possamos receber os pedidos em nosso sistema. Credenciais de Produção começarão com a letra P

    Para localizar essa chave no Portal da Konduto, clique aqui e siga as instruções.
    A chave Privada, aparecerá parcialmente oculta com um ícone de olho.

    Basta clicar sobre ele, que a chave será revelada e você pode rapidamente copiá-la.
  • Uma vez copiada a chave, adicione-a (credencial de acesso Konduto) no campo destacado a seguir.

  • Clique em "Salvar":

  • Clique na aba "Configurações de pagamento":

  • Você encontrará todas as bandeiras de cartão habilitadas no seu ecommerce. Clique em cada uma delas para adicionar a análise da Konduto individualmente. 
    Repita os passos que seguem-se até que todas as bandeiras possuam a mesma configuração:

  • Altere o status para "Ativa" clicando sobre a chave conforme indicado abaixo:

  • Selecione o box "Usar Antifraude":

  • Selecione a opção "Konduto - Nova configuração":

  • Clique em "Salvar" finalizar as configurações:

6. Acompanhe seus pedidos na Plataforma da VTEX

É possível acompanhar o andamento dos seus pedidos diretamente no seu Portal de lojista VTEX de forma mais detalhada.

  • É preciso que, dentro do menu "PCI Gateway", você clique em "Transações":

  • Você poderá acompanhar todos os pedidos de forma mais detalhada ao clicar em cada um individualmente: