Módulo de integração Pagar.me para Magento 1.x
- Magento Community 1.7.x, 1.8.x ou 1.9.x.
- PHP >= 5.4.x
- Cron
- Clique aqui e baixe o arquivo
.zip
de nossa versão mais recente. O arquivo possui o nome parecido compagarme-magento-<VERSÃO>.zip
- Descompacte o arquivo zip e copie as pastas
app
,js
,skin
evendor
para a a pasta raiz da sua instalação do Magento - Limpe o cache em
Sistema > Gerenciamento de Cache
composer require pagarme/pagarme-magento:^3
- Acesse o painel administrativo da sua loja
- Vá em
Sistema > Configuração > Métodos de Pagamento > Pagar.me
- Informe sua Chave de API e sua Chave de criptografia
- Salve as configurações
- Em
Sistema > Configuração > Configuração do cliente > Opções de Nome e Endereço
, altere o valor dos campos:
Número de linhas em um endereço de rua
com valor4
Exibir Tax/Vat
com valorHabilitado
- Salve as configurações
- Vá em
Sistema > Configuração > Catálogo > Inventário > Opções de estoque
- Altere a opção
Reajustar Estoque Quando Pedidor for Cancelado
paraSim
Você pode acessar as demais instruções de configuração clicando aqui
Pedidos que forem criados na plataforma com boleto como forma de pagamento, deverão ser cancelados após o vencimento. O módulo possui um processo automatizado que, identifica os boletos pendentes e, se em 7 dias após a data de vencimento não houver o pagamento, o pedido é cancelado.
Para que este processo funcione é preciso que as a cron da plataforma seja configurada no servidor:
*/5 * * * * sh /path/to/your/magento/site/root/cron.sh
A instrução acima irá executar o módulo de gerenciamento de tarefas agendadas a cada 5 minutos.
Mais detalhes sobre esta configuração no link
- Clonando o projeto
git clone git@github.com:pagarme/pagarme-magento.git
- Preparando o ambiente (containers)
Obs: Utilizamos o make
para tornar a utilização mais amigável mas é possível obter os mesmos resultados executando comandos através dos containers utilizando o docker-compose
. Para isso basta consultar o Makefile
do projeto.
make
O comando acima irá:
- Subir os containers docker
- Instalar as dependências do projeto através do Composer
- Habilitar os logs da plataforma (system e exception)
- Habilitar a exibição de erros da plataforma
make phpcs target=NOME DO ARQUIVO OU DIRETORIO
make test-unit
a) Todas as suites de teste
make test-e2e
b) Uma suite específica. Veja todas as disponíveis no behat.yml do projeto
make test-e2e-suite suite=NOME_DA_SUITE
- Instale um cliente VNC. Sugerimos o Vinagre
- Conecte-se no servidor.
- Utilize
localhost
para o host esecret
para senha
Todos os comandos podem ser conferidos no arquivo Makefile do projeto
- "Matando" os containers
make down
- Acompanhando (tail -f) os logs do magento
make tailf-system-logs
ou
make tailf-exception-logs
- Recuperando api key (Pagar.me) configurada no módulo
make get-api-key
- Alterando api key (Pagar.me)
make set-api-key api_key=SUA_API_KEY
Requisitos
- Ngrok
- Developer mode do magento habilitado ou a variável de ambiente
PAGARME_DEVELOPMENT=enabled
- Instale e inicie o ngrok com
ngrok http 80
- Acesse o painel administrativo da loja
- Vá
Sistema > Configuração > Métodos de Pagamento > Pagar.me
- Preencha o campo
Postback URL
com a url gerada pelo ngrok - Crie uma transação
- Uma vez criada uma transação basta executar alguma operação que invoque um postback: estorno, pagamento de boleto, etc.
- Altere seu arquivo
/etc/hosts
adicionando a entrada127.0.0.1 magento
- Acesse a loja no navegador utilizando o endereço
http://magento