DOCUMENTAÇÃO DE INSTALAÇÃO
MÓDULO MAGENTO
ÍNDICE
1 - INTRODUÇÃO
2
2 - DOWNLOAD DO PLUG-IN MAXIPAGO!
3
3 - INSTALANDO O PLUG-IN MAXIPAGO!
4
4 - CONFIGURANDO O PLUG-IN MAXIPAGO!
5
4.1 – CONFIGURAÇÕES GLOBAIS
5
4.2 – CONFIGURAÇÕES DE CARTÃO DE CRÉDITO
6
4.3 – CONFIGURAÇÕES DE BOLETO
8
4.4 – CONFIGURAÇÕES DE TRANSFERÊNCIA ONLINE
10
4.5 – CONFIGURAÇÕES DE REDEPAY
11
5 – CONFIGURAÇÕES ADICIONAIS
12
6 – CONFIGURAÇÃO DA CRON
13
1 - Introdução
Este manual tem como finalidade, auxiliar nossos clientes no processo de instalação e configuração do plug-in para a plataforma Magento.
Nossa intenção é minimizar suas dúvidas, no entanto, se elas surgirem estaremos à disposição para auxiliá-lo através dos nossos canais de atendimento, listados abaixo:
Suporte ao Cliente maxiPago!
E-mail: suporte@maxipago.com
2 - 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”.
3 - 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;
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”;
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.
4 - Configurando o Plug-in maxiPago!
4.1 – Configurações Globais
No painel administrativo da loja virtual, no painel de navegação principal clique no botão “maxiPago!”.
Na tela de configuração do Plug-in do maxiPago!, inicialmente iremos informar os dados de 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.
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.
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.
4.4 – Configurações de Transferência Online
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.
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.
5 – 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”.
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
6 – 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:
---* ---* ---* ---* ---* 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.
7 - Suporte
O suporte aos desenvolvedores é feito exclusivamente através do nosso Portal de Suporte. Os dados de acesso são enviados para os nossos clientes a partir do e-mail suporte@maxipago.com com o assunto "maxiPago! e-mail de boas-vindas" para o e-mail usado no credenciamento.
A equipe de suporte da maxiPago! pode lhe ajudar com a integração do seu sistema.
Suporte ao Cliente maxiPago! E-mail: suporte@maxipago.com