Módulo Mercado Pago Magento 2
Esse processo irá explicar a instalação do módulo Mercado Pago via Composer:
Instalação via Composer
- Execute o comando para adicionar o modulo no Composer:
composer require mercadopago/magento2-plugin
- Execute o comando para atualizar o Magento:
bin/magento setup:upgrade
- Execute o comando para limpar o cache do Magento:
bin/magento cache:clean
- Quando a loja está no modo production, é necessário gerar novamente os arquivos estáticos:
bin/magento setup:static-content:deploy
- Caso tenha problemas com as permissões de pasta ao acessar a loja, será necessário renovar as permissões das pastas:
chmod 777 -R var/ pub/ generated/
- Pronto! o módulo do Mercado Pago foi instalado com sucesso.
Magento
- Requisitos
- Funcionalidades
- Instalação
- Atualização
- Checkout Custom (Transparente)
- Checkout Básico
- Configurações de status de Notificações de Pagamento
- Suporte
O módulo do Mercado Pago para o Magento esta integrado com as seguintes funcionalidades e soluções de pagamento:
Checkout básico | Checkout Transparente | |
---|---|---|
Pagamento com Cartão de Crédito | ✔ | ✔ |
Pagamento com outros meios (Boleto) | ✔ | |
Split payments (Two cards) | ✔ | ✔ |
Pagamento com um click (Clientes e Cartões) | ✔ | |
Assinatura (Recorrência) | ✔ | |
MercadoEnvios | ✔ | |
Devolução de Pagamentos | ✔ | ✔ |
Atualização do pedido através de Cron | ✔ | |
Página de sucesso personalizável | ✔ | |
Calculadora de Parcelas | ✔ | ✔ |
Requisitos:
Detalle | |
---|---|
Versões Suportadas | Community Edition 1.8.x – 1.9.x, Enterprise Edition 1.11.x – 1.14.x |
Ambiente | LAMP (Linux, Apache, MySQL y PHP) ó LNMP stack |
Sitema Operacional | Linux x86, Windows x86-64 |
Servidor Web | Apache 2.x, Nginx 1.7.x |
Versão PHP | PHP 5.6, 5.5 y 5.4 |
Versão MySQL | MySQL 5.6 (Oracle o Percona) |
Dependências | PDO_MySQL, simplexml, mcrypt, hash, GD, DOM, iconv, curl, SOAP (for Webservices API) |
Configurações adicionais | safe_mode off * memory_limit maior que 256MB (512MB é o recomendado) |
SSL | Isso é obrigatório para ir para produção e utilizar nosso checkout transparente. Durante os testes você pode utilizar as credenciais de SandBox sem a necessidade de https. |
Instalação:
Esse processo irá explicar a instalação do módulo Mercado Pago via Package e Marketplace:
Instalação via Marketplace
- Vá até o Magento Marketplace, pesquise por Mercado Pago Payment, selecione o módulo para versão M1, adicione o módulo no carrinho e finalize o processo de compra (você não terá custo nenhum):
- Ao finalizar o processo de compra, clique em Install e copie o link que será disponibilizado na tela: O link copiado deve ser igual a esse:https://connect20.magentocommerce.com/e848b7a0bc8735cd525582c/mercadopago+MercadoPago-2.9.0
- Para efetuar a instalação iremos utilizar a ferramenta Magento Connect Manager, acesse o admin do Magento e vá até o menu System > Magento Connect > Magento Connect Manager.
- Cole o link obtido no Magento Marketplace na opção Install New Extensions e click em Install.
- Pronto! o módulo do Mercado Pago foi instalado com sucesso.
Instalação via Package
- Vá até o Github do Módulo Magento do Mercado Pago, faça o download do arquivo que possui a extensão .tgz (Exemplo: MercadoPago-2.10.0.tgz):
- Para efetuar a instalação iremos utilizar a ferramenta Magento Connect Manager, acesse o admin do Magento e vá até o menu System > Magento Connect > Magento Connect Manager.
- Faça o upload do arquivo na opção Direct package file upload e click em Upload:

- Pronto! o módulo do Mercado Pago foi instalado com sucesso.
Atualização:
Caso você ja possua o módulo do Mercado Pago e deseja instalar uma versão mais atual do módulo, aconselhamos remover todos os arquivos relacionados aos módulo anterior.
A lista de arquivos e pasta a ser removida:
- app/code/community/MercadoPago
- app/design/adminhtml/default/default/layout/mercadopago.xml
- app/design/frontend/base/default/layout/mercadopago.xml
- app/design/adminhtml/default/default/template/mercadopago
- app/design/frontend/base/default/template/mercadopago
- js/mercadopago
- skin/adminhtml/default/default/mercadopago
- skin/frontend/base/default/mercadopago
- lib/MercadoPago
- app/etc/modules/MercadoPago_Core.xml
- app/etc/modules/MercadoPago_MercadoEnvios.xml
- app/etc/modules/MercadoPago_OneStepCheckout.xml
- app/locale/en_US/MercadoPago_Core.csv
- app/locale/es_AR/MercadoPago_Core.csv
- app/locale/es_CL/MercadoPago_Core.csv
- app/locale/es_CO/MercadoPago_Core.csv
- app/locale/es_ES/MercadoPago_Core.csv
- app/locale/es_MX/MercadoPago_Core.csv
- app/locale/es_VE/MercadoPago_Core.csv
- app/locale/pt_BR/MercadoPago_Core.csv
Depois de feito esse processo, execute o processo de Instalação.
Lembre-se sempre de realizar um backup da sua loja antes de fazer qualquer alteração.
Configurando Cartão de Crédito e Boleto:
Esse processo irá explicar como configurar o módulo para aceitar pagamentos com Checkout Custom (Transparente) com Cartão de crédito e Boleto:
- Vá até o menu Systems > Configuration, na pagina de configurações vá até a opção Payment Methods:

- Para configurar as credenciais acesse a opção Mercado Pago – Custom Checkout, irá aparecer o campo da Public Key e o campo do Access Token. Obtenha suas credenciais

Existem dois tipos de credenciais:
- Modo Sandbox: As credenciais desse modo são utilizadas para realizar testes.
- Modo Produção: As credenciais desse modo são utilizadas para receber os pagamentos em Produção. Para utilizar as credenciais do Modo Produção é necessário preencher o formulário Eu quero ir para produção.
- Com as credenciais preenchidas, é necessário habilitar os métodos de pagamento. Clique no botão Configuree marque a opção Enable como Yes. Faça esse processo para o Checkout Custom – Credit Card e para o Checkout Custom – Ticket e logo seguida clique em Save Config.

- Pronto! o Checkout Custom com Cartão de crédito e Boleto foi configurado e habilitado com sucesso!

Configurando o Checkout Clássico (Redirect, Iframe e LightBox):
Esse processo irá explicar como configurar o módulo para aceitar pagamentos com o Checkout Clássico no Redirect, Iframe ou Lightbox:
- Vá até o menu Systems > Configuration, na pagina de configurações vá até a opção Payment Methods:

- Para configurar as credenciais acesse a opção Mercado Pago – Classic Checkout, logo em seguida clique em Configure. Irá aparecer o campo de Client id e o campo Client Secret. Obtenha suas credenciais

- Com as credenciais preenchidas, agora é necessário habilitar o método de pagamento. Vá até a opção Enablee marque como Yes. Aproveite e também configure o Tipo do Checkout (Type Checkout) e se o usuário deve retornar a sua loja ao finalizar o checkout (Auto Redirect).

- Pronto! o Checkout Clássico com Cartão de crédito e Boleto foi configurado e habilitado com sucesso!

Configurando o Mercado Envios:
Esse processo irá explicar como configurar o módulo para aceitar Mercado Envios:
- Primeiro, Você precisa habilitar o Mercado Envios na sua conta Mercado Pago.
IMPORTANTE: A sua conta Mercado Pago tem que ser do tipo Vendedor.
- Vá até o menu Systems > Configuration, na pagina de configurações vá até a opção Shipping Methods:
- Para habilitar o Mercado Envios acesse a opção MercadoEnvios, logo em seguida clique em Configure. Irá aparecer o campo de Enable marque esse campo com a opção Yes:
- Vá até a opção Product attributes mapping e selecione de acordo com os atributos que você possui configurado em sua loja. Aproveite e configure os métodos de envio disponível, na opção Available shipping methods. Clique na opção Save Config para salvar as configurações realizadas:
- Pronto! O Mercado Envios foi habilitado e configurado com sucesso!
Configurando o Pagamento Recorrente:
Esse processo irá explicar como configurar o módulo para aceitar pagamentos recorrentes:
- Vá até o menu Systems > Configuration, na pagina de configurações vá até a opção Payment Methods:
- Para configurar as credenciais acesse a opção Mercado Pago – Recurring Payments, logo em seguida clique em Configure. Irá aparecer o campo de Client id e o campo Client Secret. Obtenha suas credenciais
- Com as credenciais preenchidas, agora é necessário habilitar o método de pagamento. Vá até a opção Enablee marque como Yes.
- Pronto! o Pagamento Recorrente foi configurado com sucesso!
Configurações de status de Notificações de Pagamento:
Esse processo irá explicar como configurar os status de pedido para as notificações de pagamento:
- Vá até o menu Systems > Configuration, na pagina de configurações vá até a opção Payment Methods:
- Para configurar os status acesse a opção Mercado Pago – Global Configuration, vá até a opção Order Status Options. Para cada status de pagamento você poderá escolher um status de pedido, assim que a sua loja receber a notificação de pagamento o módulo atualizará automaticamente o pedido para o status escolhido. Para salvar as configurações clique no botão Save Config.
O módulo está preparado para receber as notificações de pagamento de forma automática, ou seja, sem a necessidade de configurar a sua conta Mercado Pago ou o módulo.
- Pronto! os status de notificação foram configurados com sucesso