Configurando o módulo Pagar.me na plataforma VTEX
Agora que você já encontrou o complemento do Pagar.me no seu painel da VTEX, é preciso configurá-lo. Vamos lá!
Configurações gerais
O primeiro passo é abrir o menu de opções, procurar na seção "OUTROS" por "PagarMe" e clicar para abrir a página de configuração do Gateway, como mostra a imagem abaixo:
Assim que a página é aberta, você verá vários campos na janela "Dados fornecidos por: PagarMeV2", como mostra a imagem abaixo. Aqui é possível fazer alterações gerais sobre o funcionamento do módulo.
Explicando os campos da imagem acima:
Application Key
Neste campo você deve colocar a sua api_key, de acordo com o ambiente que você deseja usar, Live ou Test. Veja mais sobre essa chave em: (Chaves de acesso)[https://docs.pagar.me/docs/api-key-e-encryption-key]
Atenção
Garanta que a versão de API configurada em sua conta Pagar.me é a 07-17-2017. Você pode verificar essa informação diretamente na Dashboard do Pagar.me junto com as chaves de API. Se a versão configurada for diferente, você pode ajustar na própria Dashboard.
Atenção!
A chave que for usada nesse campo determina em qual modo todos os módulos (Pagar.me Boleto e Pagar.me Cartões) funcionarão. Dessa forma, se você usar a API Key
test, por exemplo, todas as suas opções de pagamento via Pagar.me estarão em modo Teste, que não processa transações reais.
Application Token
Este campo deve ser deixado em branco.
Ativando a opção de Boleto Bancário
Para continuar o processo volte ao menu de "Configurações" pela rota: Pagamentos > Configurações. Vamos configurar agora a opção de pagamento através do Boleto Pagar.me.
Clique na opção "Condições de Pagamento" e, em seguida, no botão verde "+" para adicionar a opção de pagamento de boleto, como mostra a imagem abaixo:
No menu de opções, procure na seção "BOLETO" por "Boleto Bancário" e clique para abrir a página de configuração, como mostra o caminho da imagem abaixo:
Assim que a página for carregada, clique na seta para abrir a lista de opções do menu "Processar com a afiliação".
Na tela que foi aberta, selecione então a opção "PagarMeV2 - Nova configuração", como mostra a imagem abaixo. Em seguida, mude o status para "Ativa" e clique em "Salvar".
Depois que isso for feito, uma mensagem de sucesso é mostrada na tela, indicando que você configurou corretamente a opção de Boleto bancário no módulo do Pagar.me.
Tempo de espera
Depois que a opção de boleto for ativada no seu módulo, leva aproximadamente 10 minutos para que as mudanças sejam registradas e apareçam na página de checkout do seu site.
Configurações de Cartão de crédito
Da mesma forma que o Boleto, volte ao menu "Configurações", pela rota: Pagamentos > Configurações. Vamos configurar agora a opção de pagamento através de Cartão de Crédito Pagar.me.
O primeiro passo para a configuração do cartão do crédito é abrir novamente o menu de opções, procurar na seção "OUTROS" por "PagarMeV2" e clicar para abrir a página de configuração do Gateway, como mostra a imagem abaixo:
Assim que a página é aberta, você pode ver vários campos em "Dados fornecidos por: PagarMeV2", como mostra a imagem abaixo. Aqui, é possível fazer alterações gerais sobre o funcionamento do módulo.
Explicando os campos da imagem acima:
Application Key
Neste campo você precisa colocar a sua api_key, de acordo com o ambiente que você deseja usar, Live ou Test. Veja mais sobre essa chave em: Chaves de acesso
Atenção!
A chave que for usada nesse campo determina em qual modo todos os módulos (Pagar.me Boleto e Pagar.me Cartões) funcionarão. Dessa forma, se você usar a API Key
test, por exemplo, todas as suas opções de pagamento via Pagar.me estarão em modo Teste, que não processa transações reais.
Exemplo de API Key para produção: ak_live_qlSlEXJgsqaCjKohh5AZfnqv7OLP5Q
Exemplo de API Key para teste: ak_test_grXijQ4GicOa2BLGZrDRTR5qNQxJW0
Application Token
Este campo deve ser deixado em branco.
Configuração por Bandeira
Feito isso, a configuração de recebimento por cartão de crédito via Pagar.me na VTEX pode ser feita de maneira individual para cada bandeira. Portanto, basta repetir o passo a passo a seguir para cada bandeira que você desejar aceitar pelo Pagar.me
Bandeiras aceitas
As bandeiras aceitas pelo Pagar.me através deste conector da VTEX são: Visa, Mastercard, American Express, Elo, Hipercard, Diners e Aura.
Dentro do menu PCI Gateway, selecione a opção "Condições de pagamento" e clique no botão verde "+" para adicionar uma nova configuração de recebimento por cartão.
No menu de opções, procure na seção "CARTÃO DE CRÉDITO" por cada bandeira que gostaria de configurar (dentre as aceitas pelo Pagar.me) e clique sobre o nome de cada uma para abrir a página de configuração.
Atenção
Para o conector Pagar.me v2, ainda não está disponível a integração com as bandeiras Discover e JCB.
No exemplo a seguir selecionamos a bandeira "VISA".
Assim que a página for carregada, clique na seta para abrir a lista de opções do menu "Processar com a afiliação". Selecione então a opção "Pagar.me v2 - nova configuração" e, em seguida, mude o status para "Ativa".
Atenção!
A opção "Usar Antifraude", como é mostrada na imagem abaixo, deve permanecer desmarcada.
Depois de ativar a opção de pagamento com aquela bandeira, você pode configurar condições especiais de pagamento para compras à vista ou parceladas. Para começar a fazer isso, escolha "À vista" no centro da tela e clique no botão "+ Adicionar condição especial".
Existem algumas opções e você pode configurá-las da maneira que achar melhor. Depois de finalizar essa etapa, clique em "Salvar".
Caso não queira adicionar nenhuma condição especial para pagamentos à vista, clique diretamente na opção "Parcelado".
Nas configurações de Parcelamento, você determina os valores de parcela mínima, data de cobrança e se algum grupo de parcelas terá cobrança de juros, como mostra a imagem abaixo:
Explicando os campos da imagem acima:
Total de parcelas
Aqui você escolhe um número fixo ou um intervalo de número de parcelas que será oferecido aos seus clientes. Escolhendo um intervalo, você pode configurar juros para cada número de parcelas dentro desse intervalo.
Parcela mínima
Caso queira, você pode definir qual é o valor mínimo permitido para as parcelas de qualquer pedido na sua loja. Quando isso é configurado, o módulo mostra sempre o maior número até que o valor seja atingido.
Por exemplo: o produto A custa R$100,00, mas o seu módulo está configurado com a parcela mínima de R$70,00. Neste caso, a única opção disponível será o pagamento à vista. Se o produto B tem o valor de R$150,00, com a mesma parcela mínima de R$70,00, neste caso então existe a opção de uma ou duas parcelas.
Cobrança
Botão Adicionar Juros: selecionando esse botão, o menu mostra a opção de inserir juros para as parcelas do intervalo selecionado. Basta colocar o valor no campo "Juros%" a frente de cada parcela, como mostra a imagem abaixo:
Ao finalizar a configuração da bandeira escolhida, clique em "Salvar". Uma mensagem é mostrada indicando o sucesso da operação. Repita o processo para todas as bandeiras que você deseja aceitar via Pagar.me.
Tempo de espera
Depois que a opção de cada bandeira for ativada e configurada no seu módulo, leva aproximadamente 10 minutos para que as mudanças sejam registradas e apareçam na página de checkout do seu site.
Procedimentos para fazer captura manual na VTEX
Observação:
Para ser possível fazer a captura manual na VTEX, o pedido necessita ter obtido a autorização do pagamento com sucesso (status
Carência para Cancelamento/Window to cancellation)
Etapas
- Encontre o pedido, por um dos meios abaixo:
- Pelo OMS, localize o pedido pelo número.
- Ou pelo PCI Gateway, através do link
Pedido: XXXXXX, que fica no canto superior direito da tela, como mostra a imagem abaixo:
- Na tela do pedido, encontre o diagrama do fluxo de compra. Valide se o mesmo se encontra no status
Carência para Cancelamento/Window to cancellation.
- Neste diagrama, clique na setinha verde que é mostrada ao lado direito da caixa de status
Carência para Cancelamento/Window to cancellation. Uma tela é aberta, com alguns alertas, conforme mostra a imagem abaixo. Esses alertas servem para indicar que você entende que a captura manual não pode ser desfeita, e que você está mexendo no fluxo padrão da plataforma.
Confirme as três opções para iniciar o processo, e em seguida clique em Confirm.
- Note que, ao fazer isso, o status atual do pedido muda de
Carência para Cancelamento/Window to cancellationparaPronto para o Manuseio/Ready for Handling. O próximo passo é clicar na seta azul próxima à caixa de status, para seguir para o statusIniciar Manuseio/Start handling, conforme mostra a imagem abaixo:
Confirme novamente as 3 opções para seguir com as alterações, e então clique em Confirm para salvar essa mudança.
- Confirme que o status atual do pedido mudou de
Pronto para o Manuseio/Ready for HandlingparaPreparando Entrega/Handling Shipping.
Após confirmar, encontre o botão Preparar envio da nota fiscal/Setup invoice sending, que fica abaixo da lista de ítens do pedido, para inserir os dados da nota fiscal. É importante destacar que a VTEX só permite seguir com o status se houver os dados de nota fiscal.
- Preencha corretamente os dados no formulário de nota fiscal, correspondentes aos campos:
- Número da Nota Fiscal/Invoice Number
- Data da Nota Fiscal/Issue Date
- URL da Nota Fiscal/Invoice URL
- Chave da Nota Fiscal/Invoice Key
Se houver dados da transportadora, eles também devem ser preenchidos:
- Número de rastreio/Tracking number
- URL de rastreio/Trackin URL
- Transportadora/Courier
Se não houver dados, marque a caixa de seleção Não possuo código de rastreio para este pacote/I don't have a tracking code for this package.
Após preencher os dados, clique no botão Enviar Nota Fiscal/Send Invoice.
- Após realizar este processo, o pedido deve então se encontrar no status
Faturado/Invoiced, como mostra a imagem abaixo:
Confira também na seção do pagamento, no PCI Gateway, que a captura do pagamento foi realizada com sucesso, obtendo o status Finished, como mostra a imagem abaixo:
Updated almost 5 years ago