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 suporte@malga.io 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 suporte@malga.io.