Neste artigo, apresentaremos um guia passo a passo sobre como configurar o gateway de pagamento em nossa plataforma de e-commerce. Antes de começarmos o processo, é importante que você acesse sua conta na Pagar.me. Se você não tem o link de acesso, clique aqui para obter o acesso necessário.
Aviso Importante
Para garantir uma integração bem-sucedida, é essencial estar utilizando a versão 5.0 da API da Pagar.me. Caso esteja operando em uma versão anterior à 5.0, pedimos que entre em contato com o suporte da Pagar.me para solicitar a atualização necessária.
É de extrema importância que ao realizar testes na versão, todas as formas de pagamento estejam com a versão 5 configuradas conforme o ponto "Vinculando o gateway de pagamento aos meios de pagamento existentes" dessa documentação.
Para verificar qual é a versão da sua API, siga o passo a passo abaixo:
Acesse o painel da Pagar.me.
Navegue até o menu e selecione a opção "Configurações > Chaves".
As informações sobre a versão da sua API estarão disponíveis na seção Dados da API, conforme (imagem 2).
Clique na imagem para ampliar.
Caso as chaves ainda não existam criadas em sua aplicação, basta clicar em criar chaves, informar o nome da aplicação.
Clique na imagem para ampliar.
Clique na imagem para ampliar.
Clique na imagem para ampliar.
Buscando as Chaves da API
Após validar a versão da sua conta Pagar.me, navegue no menu lateral até a opção Configurações > Chaves.
Clique na imagem para ampliar.
Você irá visualizar as informações de versão da API, ID da conta, chave pública e chave secreta.
Clique na imagem para ampliar.
Configurando a Pagar.me V5 na Plataforma Ecommerce
Copie os dados de Chave Pública e Chave Secreta e insira no local indicado dentro do seu painel da sua Plataforma Ecommece, conforme mencionado abaixo.
Aviso Importante
Caso esta opção não esteja liberada em sua painel de controle, será necessário realizar contato via chat ou ticket solicitando a liberação para seu operador.
Acessando o menu Configurações > Pagamentos > Gateways.
Clique na imagem para ampliar.
Após acessar a tela de configuração basta informar as chaves copiadas anteriormente no painel da Pagar.me. Após realizar o preenchimento das informações conforme imagem abaixo, será necessário copiar a URL de notificação disponibilizada nesta tela para concluirmos o processo no painel da Pagarme.
Configurando o retorno da transação e o tipo de autorização
Tipo de Autorização - É utilizado para determinar se será utilizado a Pagarme, como gateway e analise de risco juntos ou apenas com a função gateway. Sendo a análise de risco configurada diretamente na plataforma.
Tempo de expiração - Representa o tempo que o pix ficará aguardando pagamento até ter cancelado.
Mapa de status - Representa o retorno dos respectivos status em nossa plataforma, sugerimos deixar conforme a imagem ilustrativa abaixo.
Clique na imagem para ampliar.
O campo Chave Secreta deve conter um código que geralmente começa a sigla sk.
Já o campo Chave Pública deve conter um código que geralmente começa com a sigla pk. Não utilizamos na Moovin os dados de ID de Conta.
Após salvar a URL de notificação, vá ao painel da Pagar.me e selecione o menu Configurações > Webhook. Então, insira a URL previamente copiada no campo designado 'URL', conforme demonstrado na imagem abaixo.
Caso não visualize a URL no seu painel administrativo, aqui abaixo está o modelo. Basta trocar o local indicado na URL pelo domínio da sua loja:
https://www.sualoja.com.br/api/confirmacao_transacao/pagarmev5/1
Clique na imagem para ampliar.
Numero de tentativas: Neste campo insira o número de tentativas de notificação do webhook. Aconselhamos a deixar em branco essa opção.
Habilita Autenticação: Para a Ecomece não é necessário autenticação. Deixe esta configuração desativada.
Clique na imagem para ampliar.
Eventos: Neste pequeno mapa de eventos, clique em "Pedido" e marque as opções order.canceled, order.closed, order.paid, order.payment_failed, order.update e order.created
Clique na imagem para ampliar.
Confirmar Criação: Por fim, informe sua senha para salvar o webhook e clique em salvar.
Configurações de Conta
Por fim, valide as configurações de sua conta acessando Configurações > Conta no seu painel da pagar.me. Clique em editar para validar os dados.
Clique na imagem para ampliar.
No campo "Domínios", insira o domínio da sua loja, conforme mostramos no exemplo na imagem abaixo:
ATENÇÃO: Insira apenas o domínio da sua loja, não precisa inserir "https" ou "www", somente o domínio.
Clique na imagem para ampliar.
No campo "Integração" e "Mantenedor" preencha conforme a imagem abaixo:
Clique na imagem para ampliar.
Integração: Moovin
Mantenedor: Moovin
Depois de inserir o domínio e integração, informe sua senha e salve as alterações realizadas para estarem sendo aplicadas.
Caso necessite de ajuda a identificar seu domínio acesse nossa documentação aqui.
Vinculando o gateway de pagamento aos meios de pagamento existentes
Após realizar a configuração do gateway de pagamento, agora precisamos vincular o mesmo as formas de pagamento que deseja utilizar, conforme o passo a passo abaixo.
Acesse o menu Configurações > Pagamentos > Formas de Pagamento.
Clique na imagem para ampliar.
Para configurar a forma de pagamento desejada, siga estes passos simples:
Ao acessar a opção de configuração da forma de pagamento escolhida, basta selecionar o gateway de pagamento Pagarme V5. Se ainda não tiver definido o número máximo de parcelas e os descontos para as parcelas, insira as informações no campo "Parcelamento Máximo". Para Boleto e Pix, defina a quantidade como 1.
Para exibir as Parcelas será necessário salvar as configurações, após realizar o procedimento o sistema criará várias opções de parcelamento. Agora você poderá configurar descontos ou acréscimos para cada parcela, conforme necessário.
Clique na imagem para ampliar.
Testando a Integração
Após realizar estas configurações acima, alterando a forma de pagamento para o gateway PagarmeV5, realize um pedido teste de boleto e outro de cartão para verificar se as informações estão corretas. Para validar se o pedido foi para o gateway, acesse o detalhe do mesmo e verifique o bloco de Transação do Pagamento e veja se foi gerado um ID de Transação conforme imagem abaixo:
Clique na imagem para ampliar.
Se encontrar qualquer dificuldade ou tiver perguntas, estamos aqui para ajudar! Clique aqui para acessar nosso canal de suporte.
Nossas equipes estão prontas para atendê-lo através dos diversos canais de atendimento disponíveis.
Seu feedback é extremamente importante para nós!
Por gentileza, tire um momento para avaliar a documentação que acabou de ler. Suas opiniões são cruciais para aprimorarmos nossa plataforma e proporcionar a melhor experiência possível.
Clique no quadro abaixo para deixar sua avaliação.