Pagar.me Magento

Módulo de integração Pagar.me para Magento 1.x

Requisitos

Magento Community 1.7.x, 1.8.x ou 1.9.x.
PHP >= 5.4.x
Cron

Instalação

Manual

Clique aqui e baixe o arquivo .zip de nossa versão mais recente. O arquivo possui o nome parecido com pagarme-magento-<VERSÃO>.zip
Descompacte o arquivo zip e copie as pastas app, js, skin e vendor para a a pasta raiz da sua instalação do Magento
Limpe o cache em Sistema > Gerenciamento de Cache

Composer

composer require pagarme/pagarme-magento:^3

Configuração

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 valor 4
Exibir Tax/Vat com valor Habilitado

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 para Sim

Você pode acessar as demais instruções de configuração clicando aqui

Configuração de cancelamento automático de boletos não pagos

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

Para desenvolvedores - Avançado

Requisitos

Instalando o Magento Community 1.x

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

Executando o PHPCS (Code sniffer)

make phpcs target=NOME DO ARQUIVO OU DIRETORIO

Executando os testes unitários

make test-unit

Executando os testes de comportamento

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

Acompanhando a execução dos testes de comportamento

Instale um cliente VNC. Sugerimos o Vinagre
Conecte-se no servidor.

Utilize localhost para o host e secret para senha

Comandos úteis para desenvolvimento

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

Testando postbacks em ambiente de desenvolvimento

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.