Instalando o módulo Magento Pagar.me

❗️

Módulo descontinuado

Esse módulo foi descontinuado e não prestamos mais suporte a novas integrações.

Instalação Manual

1. Baixar a última versão aqui;
2. Descompactar o arquivo baixado e copiar as pastas app, js, skin e vendor para dentro do diretório principal do Magento;
3. Limpar o cache do Magento em Sistema > Gerenciamento de Cache.

📘

Copiando as pastas app, js, lib, skin e vendor

Assim como o segundo item diz, você precisa copiar algumas pastas para o diretório principal do Magento, que já é composto pelas pastas app, js e skin. Ou seja, o que você precisa é mesclar o conteúdo que acabou de baixar do repositório Pagar.me com o que já existe no Magento.

Instalação via Composer

composer require pagarme/pagarme-magento:^3

Após a instalação

O próximo passo é configurar o módulo Pagar.Me para que consiga criar as transações. Para isso siga o seguinte caminho em seu painel Magento: Sistema > Configuração > Vendas > Métodos de Pagamento ou caso seu Magento esteja em Inglês: System > Configuration > Sales > Payment Methods

Feito isso, você deve ter acesso à seguinte tela:

Vamos à explicação rápida de cada item:

Pagar.me - Configuração:

Este item diz respeito à configuração das chaves de produção e teste para o seu ambiente, definidas na sua Dashboard Pagar.me como Chave de API (API Key) e Chave de Encriptação (Encryption Key).

Pagar.me - Boleto:

Se você estiver usando os serviços de Boleto bancário do Pagar.me, este item ajuda a configurar algumas propriedades, como dias para vencimento, instruções, etc.

Pagar.me - Cartão de crédito:

Caso você esteja utilizando a opção de Checkout Transparente do Pagar.me para transações com cartão de crédito, aqui você pode configurar taxas de juros, valor mínimo de parcela, etc.

Pagar.me - Checkout Pagar.Me:

Este item define também as configurações do Checkout para cartão de crédito, mas utiliza o modal de pagamento Pagar.me para receber as informações do usuário. Veja mais em Checkout

🚧

Pagar.me Checkout vs Pagar.me Cartão de crédito

Você deve escolher entre um deles apenas.

🚧

Campos obrigatórios para criar uma transação:

Caso você opte pelo Checkout Transparente, é necessário que a sua aplicação garanta o envio dos campos CPF/CNPJ e os campos que compõem os dados dados de endereço (Rua, Número da rua, Bairro e CEP). Lembre-se sempre desses campos, pois a falta de qualquer um deles invalida a criação da transação.