Magento

Com o conector Malga para Magento, você tem disponível um módulo pronto para processar pagamentos de crédito, pix e boleto na sua loja Magento 2, sem precisar desenvolver uma linha de código, basta instalar o pacote e realizar as configurações indicadas nesta documentação.

Com total segurança para os clientes, facilidade de instalação, e contando com os recursos da Malga, é possível elevar os resultados dos ecommerces desenvolvidos em Magento, aumentando a taxa de aprovação dos pagamentos com o fluxo inteligente, o uso de condicionais e o roteamento de tentativas das cobranças em diferentes provedores.

Além disso, você gerencia as configurações de provedores de pagamento da sua loja com autonomia pelo Dashboard, e passa a contar com soluções de dados para analisar e monitorar as cobranças através do Painel de Dados, Analytics API e Exportação de cobranças.

Confira os recursos do módulo Malga para lojas Magento:

Recurso	Suporte do conector
Suporte a pagamento por Pix, cartão de crédito e boleto
Suporte aos provedores de pagamento pela Malga
Suporta antifraude
Suporta adição de condicionais no fluxo inteligente de pagamentos, exceto envio de campo personalizado na cobrança
Estorno e captura de cobranças pelo painel
Acompanhamento das cobranças e disputas pelo Dashboard Malga
Acesso aos Dados através da Exportação em .csv, Analytics API e Painel
Gestão do fluxo de pagamentos pelo Dashboard Malga

Get started

Crie uma conta Malga

A criação da sua conta de cliente na Malga é uma etapa fundamental para utilização dos serviços. Com a criação da sua conta você terá acesso às credenciais client-id e api-key necessárias para utilização dos serviços.

Entre em contato conosco pelo e-mail [e-mail] solicitando a criação da conta e as credenciais, indicando os provedores e métodos de pagamento que deseja utilizar. Para conhecer os provedores e métodos disponíveis na Malga, consulte a nossa documentação;

Instale o Módulo​ via composer

PHP >= 8.1
Magento >= 2.4

Utilize o comando composer require diretamente no terminal dentro do root do Magento 2

composer require plughacker/magento2

Depois utilizar os comandos a seguir em seu Magento root:

composer update
./bin/magento setup:upgrade
./bin/magento setup:di:compile

E pronto! 🥳 O módulo Malga para Magento 2 está instalado na sua loja.

O composer é responsável por fazer esta identificação e instalar o módulo correto. Assim que o último comando é executado, o próximo passo é realizar a configuração do módulo no Painel de Administração da loja Magento.

Configure seu módulo para realizar cobranças

Para iniciar, é necessário alterar as configurações padrão do Magento 2 para aceitar os parâmetros de comprador que são necessários para criar os pedidos.

Acesse o painel de Administração da loja no Magento 2 > Stores, clicando em Settings, conforme a imagem abaixo:

O próximo passo é definir duas configurações de Customer, acessando o menu Customer > Customer Configuration > Create New Account Options: Você deve definir o campo “Show VAT Number on Storefront” como “Yes” para que possamos utilizar o CPF/CNPJ do comprador em registro online de boletos e para utilização do antifraude.

Na sequência, você deve configurar a opção “Name and Address Options” utilizado o valor “4” no campo “Number of Lines in a Street Address” para se adequar à lógica de endereços do Brasil.

Para finalizar, acesse o menu Sales > Payment Methods, acessando Other Payment Methods > Malga, onde iniciará a configuração do módulo de pagamentos.

Configurações

No menu de Payment Methods > Malga, devem ser inseridas as chaves recebidas através do nosso time de Atendimento. Essas são as configurações responsáveis por identificar sua conta na Malga e ativar o processamento dos pagamentos.

Explicando os campos da imagem acima:

Campo	Descrição
Sandbox Mode Active	Habilita o uso do ambiente Sandbox
ClientId	Deve ser inserido o ClientId recebido durante a criação da conta na Malga
Api Key	Deve ser inserido o Api Key recebido durante a criação da conta na Malga
Merchant Key	Deve ser inserido o MerchantId recebido durante a criação da conta na Malga

Configurações de Cliente

Nas Configurações de Cliente que serão recebidos pela Malga, é possível personalizar os campos de endereço a partir do Checkout.

Nestes campos, você deve relacionar os parâmetros de Rua (Street parameter), Número (Number parameter), Bairro (Neighborhood parameter) e Complemento (Complement parameter), com a ordem das linhas de endereço presentes na página do Checkout da sua loja.

Configurações de Pagamento

Em Payment Methods, você pode utilizar a Malga para processar pagamentos em Cartão de Crédito, Pix e Boleto, que devem ser configurados conforme abaixo, assim como as opções de uso de Multimeios e Multicompradores.

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

Para processar pagamentos de Cartão de Crédito com a Malga, devem ser realizadas as seguintes configurações no Módulo:

Explicando os campos da imagem acima:

Campo	Descrição
Enabled	Ativa ou desativa a opção de oferecer cartão de crédito como método de pagamento.
Title	Nome que será mostrado na opção de cartão de crédito em sua página de finalização de pedido.
Soft descriptor	Descrição que aparecerá na fatura do cartão depois do nome de sua empresa. Máximo de 13 caracteres.
Payment action	Define se as cobranças criadas devem ser somente autorizadas ou autorizadas e capturadas.
Sort Order	Define a ordem em que os métodos de pagamento serão exibidos em sua página de finalização de pedido.

Configurações de Bandeiras

Nesta etapa, você deve configurar as bandeiras que serão aceitas na página de Checkout. Lembrando que essas bandeiras devem estar configuradas em sua conta Malga para que possam ser utilizadas pelo Módulo.

Configurações de Parcelas

Nesta etapa, você configurar as regras de Parcelamento aplicadas em seus pedidos de Cartão de Crédito.

Explicando os campos da imagem acima:

Campo	Descrição
Active	Ativa ou desativa a opção de parcelamento nos pedidos por cartão de crédito.
Default configuration for all brands	Define se as regras de parcelamento serão aplicadas a todos os pedidos (Yes) ou se serão definidas regras para cada bandeira (No).
Max number of installments	Este campo define em até quantas vezes será possível parcelar um pedido.
Min installment amount	Define o valor mínimo que uma parcela pode assumir. Caso a opção de parcelamento do pedido resulte em um valor de parcela menor do que o Min installment amount, essa opção não irá aparecer para o comprador.
Enable Interest	Ativa ou desativa a configuração de juros para esse tipo de parcelamento (definido em Default configuration for All Brands).
Initial interest rate (%)	O valor de juros passado neste campo define quanto, em porcentagem, iremos acrescentar ao valor do pedido caso seja escolhido a mínima quantidade de parcelas com juros. É possível deixar o campo como 0.
Incremental interest rate (%)	O valor de juros passado neste campo define quanto, em porcentagem, iremos acrescentar em cada parcela após a primeira em que há cobrança de juros. É possível deixar o campo como 0.
Number of installments without interest	Opção que define em até quantas parcelas daquele pedido não devem ser cobrados juros. Exemplo: se o campo esteja configurado com 3, ou seja, caso o cliente opte por comprar em 1x, 2x ou 3x, não serão adicionados juros ao valor, e caso escolha 4x ou mais, as parcelas terão juros aplicados.

Configurações de Pix

Nesta etapa, você irá definir as configurações para pagamentos por Pix:

Explicando os campos da imagem acima:

Campo	Descrição
Enabled	Ativa ou desativa a opção de Pix como método de pagamento.
Title	Esse campo define o nome que será mostrado na opção de Pix em sua página de finalização de pedido.
Sort Order	Define a ordem em que os métodos de pagamento serão exibidos no Checkout.

Configurações de Boleto

Nesta etapa, você irá definir as configurações para pagamentos por Boleto:

Explicando os campos da imagem acima:

Campo	Descrição
Enabled	Ativa ou desativa a opção de oferecer Boleto como método de pagamento.
Title	Esse campo define o nome que será mostrado na opção de Boleto em sua página de finalização de pedido.
Sort Order	Define a ordem em que os métodos de pagamento serão exibidos no Checkout.

Para receber as credenciais para configuração do Módulo Malga para Magento 2, entre em contato conosco com o nosso time de atendimento em [e-mail].