Instalando o conector no Pagar.me

Instalação no Pagar.me

Para iniciar a instalação no 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"

19141914

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

19121912

Uma vez selecionada a loja, as opções de configuração da loja ficam disponíveis. É importante se atentar que a informação de nome da conta é obrigatória.

727727

Além do Nome da Conta, outros parâmetros podem ser configurados, relativos aos meios de pagamento, uso de antifraude, VTEX InStore e captura de pagamento. Segue abaixo uma breve explicação de cada um dos parâmetros a serem preenchidos:

11171117 11151115

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.

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. Caso sejam utilizados múltiplos POS, esse campo deve ser deixado em branco.¹

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.

Descrição para Compras em PIX

Descrição adicional que será apresentado no extrato de compras realizadas via PIX (ex: nome da franquia).
Este campo será apresentado na sessão de "Informações Adicionais" do PIX e terá o seguinte formato:
"Descrição da compra" : "[texto preenchido no campo do HUB]"

Ativar Margem de Autorização

Ativa aplicação dos campos "Margem de Autorização em Percentual" e "Margem Máxima de Autorização"

Margem de Autorização em Percentual (%)

Estabelece limite de autorização de valor superior ao valor do pedido, respeitando a margem percentual preenchida.
Ex:
Valor do pedido: R$100
Margem de Autorização Percentual: 50%
Autorização: R$150

Margem máxima de autorização (Valor em reais)

Estabelece limite de autorização de valor superior ao valor do pedido, respeitando margem em reais. Se o campo "Margem de autorização percentual" não for preenchido, a Margem Máxima de Autorização não é aplicada.

Ex:
Valor do pedido: R$100
Margem de autorização percentual: 50%
Margem máxima de autorização: R$40
Autorização: R$140
Ex2:
Valor do pedido: R$100
Margem máxima de autorização: R$40
Autorização: R$100

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.

🚧

¹Serial Number do POS

A inserção do serial number na configuração do HUB, só é válida para casos de um único POS para aquela conta. Caso sejam utilizados múltiplos POS, esse campo deve ser deixado em branco.

Uma vez que as informações estiverem preenchidas da maneira que deseja, basta clicar em "Autorizar".

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.

19161916

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

275275

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.

11941194

Encontre a opção PagarMeV3

19171917

147147

No lado esquerdo da tela de adição de afiliação, será necessário nomear a afiliação que está sendo criada, no campo "Nome da Afiliação". Do lado direito existem dois campos obrigatórios que são o Application Key e Application Token, aqui devem ser inseridas as chaves geradas na sua integração do HUB.

839839

Para acessar e copiar suas chaves, siga os passos a seguir:

Acesse a página "Minhas Integrações" no HUB, via o link https://hub.pagar.me/install. Nesta página você encontrará a integração da sua conta Pagar.me com a VTEX, realizada no início deste documento. As chaves estarão ocultas e são copiadas quando você clica em cada um dos botões "ID" e "Token".

592592

Para transportar as chaves para a afiliação, clique em "ID" no HUB para copiar o Account ID e cole no campo Application Key da configuração da Afiliação Gateway VTEX. Depois, clique em "Token" no HUB para copiar o Token e cole no campo Application Token da configuração da Afiliação Gateway VTEX.

Caso você não deseje configurar o Split de pagamentos, marque a opção "Ativar split e enviar recebedores?" como NÃO. Neste caso, a sua configuração deve se parecer com a figura abaixo:

727727

Caso você deseje configurar o Split de pagamentos, marque a opção "Ativar split e enviar recebedores?" como SIM. Neste caso, a sua configuração deve se parecer com a figura abaixo:

726726

Prossiga então para o preenchimento dos demais campos de configuração da Afiliação Gateway. Os campos são os seguintes:

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

11771177

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

389389

🚧

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?