Passo a passo de integração

Pagar.me e ecom-d

Olá! Neste passo a passo vamos te explicar como realizar a integração da Pagar.me com a ecom-d.

Antes de começarmos vamos precisar de duas coisas:

• Acesso ao painel da pagar.me
• Acesso ao painel administrador da ecom-d

Com os requisitos em mãos, vamos aos passos:

1° Acessando o painel da ecom-d vamos procurar no menu lateral pela opção Configurações e depois Configurações de Pagamento.

2° Após abrir o menu Configurações de pagamento iremos clicar em Formas de pagamento online e depois clicar em Instalar na frente da opção da Pagar.me. A instalação será bem rápida e automática.

3° Após instalado, vamos clicar no botão de editar para acessar a página de configurações.

4° Após seguir os passos você irá visualizar esta tela:

Agora iremos precisar acessar o painel da pagar.me para consultar as informações Chave pública e Chave da api.

Não compartilhe essas informações com ninguém.

5° Acessando o painel da Pagarme, no menu lateral, vamos procurar por Configurações e depois Chaves.

6° Iremos copiar a informação Chave pública no painel da Pagarme e colar no campo Chave privada no painel da ecom-d.

Painel da Pagarme

Painel da ecom-d

Observação: Neste exemplo estou utilizando uma conta de teste, esse é o motivo de possuir o texto “test” nas chaves, caso esteja buscando por uma chave do ambiente de produção, o processo será o mesmo mas não irá possuir o texto “test” nas chaves.

7° Logo abaixo do campo Chave pública conseguiremos visualizar o campo Chaves da API, iremos clicar em Criar chave para adicionarmos uma nova chave.

8° Na tela que está sendo exibida iremos preencher o Nome da chave, recomendo colocar algo que facilite a identificação do propósito da chave que está criando, como por exemplo: “Plataforma ecom-d”.

Iremos marcar também o campo que concede permissão total para a chave e clicar em avançar.

9° Na próxima tela vamos marcar a permissão Leitura e escrita e inserir no campo senha a sua senha de acesso ao painel da Pagarme e depois clicar em criar chave.

10° Neste momento será gerado a outra chave que precisamos adicionar no painel da ecom-d.

Clique no botão Copiar chave secreta, depois concluir e cole no campo Chave de criptografia no painel da ecom-d.

Painel da ecom-d:

11° Voltando ao painel da ecom-d, abaixo do campo das chaves podemos visualizar as configurações do cartão de crédito.

Estarei explicando cada campo abaixo:

• Número de parcelas: Quantidade de parcelas no qual o cliente poderá selecionar para dividir seu pedido.

• Mínimo de cada parcela: Valor mínimo para dividir um pedido, por exemplo, um pedido no valor de R$10,00 com o valor mínimo de parcela de R$5,00 poderá ser dividido somente em 2X.

• Número de parcelas sem juros: Quantidade de parcelas que o cliente não vai precisar pagar o juros do parcelamento.

• Taxa de juros: Valor de juros. Recomendamos consultar a sua tabela de juros da Pagarme e adicionar o valor referente a parcela que será cobrado juros.

12º Após isso, podemos escolher quais métodos de pagamento ativar, além de ser possível configurá-los:

Cartão de crédito

Para o cartão de crédito, é possível configurar os juros por parcela. Para isso, basta informar o valor de juros a partir das configurações anteriores de número de parcelas, definindo:

1. Número de parcelas
2. Parcelas sem juros
3. Valor mínimo por parcela
4. Percentual de juros aplicado nas parcelas com acréscimo

Boleto

Para o boleto, é possível configurar o tipo de desconto a ser aplicado. Quando essa opção estiver habilitada, você poderá definir:

1. O valor ou percentual de desconto

Além disso, é possível definir outros valores para o boleto: 

2. Os dias de vencimento do boleto (esse valor será enviado ao Pagar.me e utilizado para definir o prazo de vencimento dos boletos gerados na loja virtual)
3. A opção de cancelamento automático de pedidos com boleto expirado. Esse switch abaixo permite definir se pedidos cujo boleto venceu devem ser cancelados automaticamente e retornar os itens ao estoque.

PIX

Para o PIX, também é possível configurar o tipo de desconto a ser aplicado. Quando essa opção estiver habilitada, você poderá definir:

1. O valor ou percentual de desconto
2. Os minutos de vencimento do PIX (esse valor será enviado ao Pagar.me e utilizado para definir o prazo de vencimento dos pagamentos via PIX gerados na loja virtual)
3. A opção de cancelamento automático de pedidos com PIX expirado. Esse switch abaixo permite definir se pedidos cujo PIX expirou devem ser cancelados automaticamente e retornar os itens ao estoque.

Por fim, é importante lembrar de salvar as alterações feitas:

Importante

Para que o status dos pedidos sejam atualizados de forma automática de acordo com a situação do pagamento, devemos seguir este tópico.