Comunidade de Desenvolvedores maxiPago!

Magento 1.x

 
 

Passo-a-Passo para instalação do Módulo maxiPago! para Magento

 

Este tutorial tem como finalidade, auxiliar nossos clientes no processo de instalação e configuração do plug-in para a plataforma Magento.

 

Download do Plug-in maxiPago!

 

Para efetuar o download do plug-in maxiPago! siga as instruções abaixo:

1 – Acesse o link: https://github.com/maxipago/modulo-magento;

2 – Clique no botão “Clone or Download” e em seguida na opção “Download ZIP”.

 
Download Módulo Magento maxiPago!
 

3 – Salve o arquivo em um diretório desejado e aguarde o término do download do arquivo.

 

Instalando o Plug-in maxiPago!

 

Ao finalizar o download do Plug-in maxiPago! para o Magento, descompacte o arquivo e acesse o painel administrativo de sua loja virtual.
Navegue até a opção System > Magento Connect > Magento Connect Manager e informe o usuário e senha de acesso;

 
Magento Connect Manager
 

Ao acessar o Magento Connect Manager, siga as instruções abaixo:

 

1 – Vá na sessão “Direct package file upload” e clique no botão “Escolher arquivo”;

2 – Acesse o diretório onde foi descompactado o plug-in maxiPago! para Magento e selecione o arquivo 1.6.x-1.9.x, em seguida clique no botão “Upload”;

3 – Aguarde o término do processamento do Magento e sem seguida cliente no botão “Refresh”,

4 – Verifique na coluna “Package Name” se há um pacote chamado “MaxiPago_CheckoutApi”. Caso possua o pacote, volte ao início da tela e clique na opção “Return to Admin” para que possamos configurar o módulo.

 

Configurando o Plug-in maxiPago!

 

Configurações Globais

 

No painel administrativo da loja virtual, no painel de navegação principal clique no botão “maxiPago!”.

 
Menu Principal Magento
 

Na tela de configuração do Plug-in do maxiPago!, inicialmente iremos informar os dados de Configurações Globais:

 
maxiPago! - Configurações Globais
 

  • ID da Loja – informe o merchantId de Teste (em caso de homologação) ou Produção (em caso de término da homologação) fornecido pela equipe de suporte da maxiPago!
  • Chave da Loja – informe o merchantKey de Teste (em caso de homologação) ou Produção (em caso de término da homologação) fornecido pela equipe de suporte da maxiPago!
  • Chave Secreta – informe a Secret Key de Teste (em caso de homologação) ou Produção (em caso de término da homologação) fornecido pela equipe de suporte da maxiPago!
  • Ambiente de Teste (Sandbox) – Yes, para ativar o ambiente de Teste ou No, para ativar o ambiente de Produção
  • Salvar Log – Yes, para salvar os logs de “Request” e “Response” de comunicação com a maxiPago! e No, para não salvar nenhuma informação.

 

Configurações de Cartão de Crédito

 
maxiPago! - Configuração Cartão de Crédito
 

  • Enable – Yes, para habilitar o meio de pagamento via cartão de crédito e No, para desabilitar.
  • Título – Nome de como o meio de pagamento será exibido na tela de Checkout da loja.
  • Payment from Applicable Countries – Selecione a opção “Specifc Countries”.
  • Payment from Specifc Countries – Selecione Brasil.
  • Soft Descriptor – Informe a variável a ser exibida na fatura do cartão (máximo de 13 caracteres, não podendo conter caracteres especiais ou espaço).
  • Tipo de Parcelamento – Sem Juros (parcelamento loja) ou Com Juros (parcelamento Cartão).
  • Quantidade Máxima de Parcelas – Informe a quantidade máxima de parcelas que a loja aceitará conforme contratado via adquirente.
  • Valor Mínimo de Parcelas – Valor mínimo que a loja aceitará o pagamento parcelado.
  • Tipo de Processamento – Autorização, Autorização Auto (captura automática) ou Venda Direta.
  • Tokenização de Cartão de Crédito – “Yes” para tokenizar os cartões de crédito e “No” para não trabalhar com tokenização.
  • Envio de e-mail de atualização de status do pedido – Selecione os status que deverão ser disparados os e-mails para o consumidor.

 

Configurações de Boleto

 
maxiPago! - Configuração Boleto
 

  • Enable – Yes, para habilitar o meio de pagamento via boleto e No, para desabilitar.
  • Título – Nome de como o meio de pagamento será exibido na tela de Checkout da loja.
  • Payment from Applicable Countries – Selecione a opção “Specifc Countries”.
  • Payment from Specifc Countries – Selecione Brasil.
  • Banco do Boleto – Selecione o banco que está configurado na maxiPago!
  • Dias para Vencimento – Quantidade de dias para vencimento do Boleto
  • Envio de e-mail de atualização de status do pedido – Selecione os status que deverão ser disparados os e-mails para o consumidor.

 

Configurações de Transferência Online

 
maxiPago! - Configuração Transferência Bancária
 

  • Enable – Yes, para habilitar o meio de pagamento via transferência online e No, para desabilitar.
  • Título – Nome de como o meio de pagamento será exibido na tela de Checkout da loja.
  • Payment from Applicable Countries – Selecione a opção “Specifc Countries”.
  • Payment from Specifc Countries – Selecione Brasil.
  • Banco da Transferência Online– Selecione o banco que está configurado na maxiPago!
  • Envio de e-mail de atualização de status do pedido – Selecione os status que deverão ser disparados os e-mails para o consumidor.

 

Configurações de RedePay

 
maxiPago! - Configuração maxiPay
 

  • Enable – Yes, para habilitar o meio de pagamento via RedePay e No, para desabilitar.
  • Título – Nome de como o meio de pagamento será exibido na tela de Checkout da loja.
  • Payment from Applicable Countries – Selecione a opção “Specifc Countries”.
  • Payment from Specifc Countries – Selecione Brasil.
  • Envio de e-mail de atualização de status do pedido – Selecione os status que deverão ser disparados os e-mails para o consumidor.

 

Configurações Adicionais

 

Navegue pela opção System > Configuration, ao acessar a página de configuração, no menu lateral navegue até a sessão Customers > Customers Configuration.

Primeiramente procure pela opção Create New Account Options e altere o item “Enable Automatic Assignment to Customer Group“ para “Yes”.

 
maxiPago - Magento Configuração Extra - Show VAT Number
 

Ainda na página Customers Configuration, procure pelo item “Name and Address Options” e altere os seguintes itens:

  1. Number of Lines in a Street Address para 2
  2. Show Tax/VAT Number para Required

 
maxiPago! - Configurações Adicionais - Number of Lines in a Street Address
 
maxiPago! - Configurações Adicionais - Show Tax/Vat Number
 

Configuração da Cron

 

Em todos os Sistemas Operacionais baseados no Unix é possível configurar rotinas automáticas editando o arquivo /etc/crontab. Em algumas distribuições Linux é possível editar crons individualmente por usuário através do comando “crontab -e”, tendo o acesso à contrab do usuário correspondente.

Para configurar a cron.php do Magento, edite a crontab e inclua a seguinte configuração:

nbsp;


* * * * * USUARIO php DIRETORIO_MAGENTO/cron.php


 

Onde:

 

– USUARIO representa o usuário do sistema que irá executar o script. Esse usuário devera ter permissão de execução do arquivo;

– php representa o “php-cli”, ou seja, o binário do PHP para linha de comando. Caso o php não esteja instalado nos diretórios padrão (ou não esteja exportado no PATH) é necessário indicar o caminho completo, por exemplo, /usr/local/php-5.2/bin/php.

– DIRETORIO_MAGENTO representa o caminho para o diretório do projeto Magento, por exemplo, /var/www/loja.