Instalando o conector na Pagar.me

Gerando as chaves de acesso da VTEX

Primeiro é necessário gerar as chaves de acesso da VTEX dentro da dashboard da plataforma, essas chaves servirão para o conector criar e atualizar pedidos.

As chaves precisarão de permissões especificas, sendo assim necessário criar um novo perfil de acesso para as chaves da Pagar.me. Na dashboard da VTEX acesse "Gerenciamento da conta > Perfils de acesso"

Nomeie o novo perfil e adicione nele apenas as permissões de PCI Gateway:

  • MakePayments
  • ViewPaymentData
  • ManageStore
  • ManageInfrastructure
  • NotifyPayments
    Salve esse novo perfil

Agora acesse "Gerenciamento da conta > Chaves de aplicação" e crie uma nova chave com o perfil de acesso customizado que foi criado clicando em "Gerenciar minhas chaves > Gerar chave"

Pronto! Suas chaves foram devidamente geradas. Não esqueça de salvar o token gerado, ele não poderá ser visualizado novamente.

Para mais detalhes, acesse a central de ajuda da VTEX:
Account Name
App Key e App Token

Instalação na Pagar.me

Para iniciar a instalação na Pagar.me é necessário acessar o aplicativo da VTEX no nosso HUB. Caso não esteja conectado na sua conta Pagar.me basta clicar no canto superior direito, e realizar o login com usuário e senha da dashboard.
Já no HUB para iniciar a instalação basta clicar no botão "Integrar com o Pagar.me"

Clique na caixa de seleção e selecione a loja que deseja realizar a instalação

Uma vez selecionada a loja, as opções de configuração da loja ficam disponíveis. Os primeiros dados são as chaves de acesso geradas na VTEX no passo anterior. É importante se atentar que as informações de nome da conta, VTEX App Key e VTEX App Token são obrigatórias.
Segue abaixo uma breve explicação de cada um dos parâmetros a serem preenchidos:

Parâmetro

Descrição

Nome da conta VTEX

É o nome da sua conta dentro da VTEX. Caso tenha dúvida, a VTEX possui um tutorial explicando do que se trata, clique aqui.

VTEX App Key

Se trata da chave de acesso gerada no primeiro passo. Caso tenha alguma dúvida do processo acesse o artigo da VTEX com mais detalhes clicando aqui.

VTEX App Token

Se trata do token de acesso gerado no primeiro passo. Caso tenha alguma dúvida do processo acesse o artigo da VTEX com mais detalhes clicando aqui.

Habilitar Vtex InStore

Opção para utilizar a funcionalidade omnichannel VTEX inStore do conector.

Serial Number do POS

Uma vez habilitado o inStore é necessário inserir o número serial do POS para quais os pedidos devem ser direcionados.

Dias para adicionar no vencimento do boleto

Define a data de vencimento do boleto após a emissão em dias

Instruções para o boleto

Define as instruções que serão exibidas no boleto gerado pela Pagar.me.

Utilizar número do pedido como número do documento no boleto

Utiliza o parâmetro CODE da VTEX no campo de documento.

Utilizar número do pedido como nosso número no boleto

Utiliza o parâmetro CODE da VTEX no campo de número do boleto.

Inverter TID/NSU/Code (algumas integrações de terceiros na Vtex exigem isto)

Inverte os valores enviados para a VTEX, enviando o TID no lugar do NSU e vice-versa. Essa funcionalidade é específica para algumas integrações de terceiros.

Utilizar ID da Sessão (fingerprint) quando recebido da Vtex

Eu uso antifraude via Pagar.me

Selecionar caso utilize o antifraude na Pagar.me

Eu uso antifraude diretamente via VTEX

Selecionar caso utilize o antifraude na VTEX

Valor mínimo para enviar para o antifraude (apenas via Pagar.me)

Define o valor mínimo da transação para que o pedido seja enviado para análise do antifraude. Apenas para clientes gateway.

Delay em segundos para a captura após o antifraude pela Vtex . (Use "0" para desabilitar)

Define quantos segundos a plataforma deve aguardar para realizar a captura da transação após a análise do antifraude. Apenas para clientes que utilizam o antifraude na VTEX. Caso seja desabilitado, o valor será definido pelo padrão da VTEX.

Dias para o auto cancelamento de pagamento com boleto pela Vtex. (Use "0" para desabilitar)

Define quantos dias a plataforma deve aguardar para realizar o cancelamento do pedido do boleto. Caso seja desabilitado, o valor será definido pelo padrão da VTEX.

Dias para o auto cancelamento de pagamento com cartão de crédito pela Vtex. (Use "0" para desabilitar)

Define quantos dias a plataforma deve aguardar para realizar o cancelamento do pedido após falha na autorização. Mínimo 600. Caso seja desabilitado, o valor será definido pelo padrão da VTEX.

Delay em segundos para a captura. (Use "0" para desabilitar)

Define quantos segundos a plataforma deve aguardar para realizar a captura da transação após a autorização bem sucedida. Caso seja desabilitado, o valor será definido pelo padrão da VTEX.

Preenchidas as informações para configurar a loja da maneira que deseja, basta clicar em "Autorizar".

Pronto! Agora é necessário configurar a instalação do lado da VTEX.

Instalação na VTEX

Para finalizar o processo de instalação é necessário acessar a área de administração dentro da sua loja da VTEX.

Na barra lateral selecione a opção de "Pagamentos > Configurações"

A página atualizará exibindo todas as opções de pagamento que estão configuradas na sua loja. Primeiro precisamos adicionar o Pagar.me como uma afiliação de gateway. Clique na opção "Afiliações de Gateways" e em seguida no sinal de "+" para adicionar uma nova afiliação. Ficou alguma dúvida? Clique aqui para ver o tutorial de VTEX.

Encontre a opção PagarMeV3

Na tela de adição de afiliação será necessário nomear a afiliação que está sendo criada do lado esquerdo. Do lado direito exitem dois campos obrigatórios que são o Application Key e Application Token, aqui devem ser inseridas as chaves geradas do primeiro passo.

Os campos são os seguintes

Application Key

Se trata da chave de acesso gerada no primeiro passo. Caso tenha alguma dúvida do processo acesse o artigo da VTEX com mais detalhes clicando aqui.

Application Token

Se trata do token de acesso gerado no primeiro passo. Caso tenha alguma dúvida do processo acesse o artigo da VTEX com mais detalhes clicando aqui.

Ativar split e enviar recebedores?

Define se sua loja irá ou não atuar como um marketplace. Essa configuração faz com que regras de split sejam enviadas para a Pagar.me, caso elas estejam configuradas na VTEX.

Responsabilidade pelas tarifas de pagamento

Define quem será responsável pelas tarifas de MDR cobradas pela Pagar.me, podendo ser o marketplace, os sellers ou ambos. Esse campo só é exibido caso a opção de split esteja como "SIM".

Responsabilidade pelos chargebacks

Define quem será responsável pelos chargebacks caso eles ocorram, podendo ser o marketplace, os sellers ou ambos. Esse campo só é exibido caso a opção de split esteja como "SIM".

Após configurar a afiliação basta clicar em salvar e a próximo passo é adicionar essa afiliação na condições de pagamento que desejar. Clique aqui para conferir o tutorial feito pela VTEX.
Lembre-se de selecionar a afiliação que acabou de criar e mudar o status para "Ativa". Configuradas as condições desejadas, basta clicar em salvar

Após a conclusão basta verificar se a condição de pagamento que acabou de criar está correta e ativa.

🚧

IMPORTANTE

É necessário configurar cada método de pagamento individuamente dentro da VTEX. Isso deve ser configurado após finalizar a instalação. Clique aqui para conferir o tutorial feito pela VTEX.


Did this page help you?