Conector VTEX

Através do conector Malga, é possível processar pagamentos de crédito, pix e boleto na sua loja VTEX utilizando todos os recursos e provedores do Fluxo Inteligente Malga.

Com a ativação do conector, você utiliza os recursos da nossa infraestrutura e pode realizar alterações nas configurações de pagamento da sua loja pelo Dashboard Malga, sem precisar desenvolver integrações, e também fazer o acompanhamento das cobranças através das soluções de Painel de Dados, Analytics API e Exportação de cobranças.

A integração da Malga com a VTEX foi desenvolvida através do Payment Provider Protocol e conta com certificado PCI, em conformidade aos padrões de segurança exigidos para garantir a proteção dos dados do seu cliente.

Utilizando o conector Malga, é possível ter mais autonomia para construir o fluxo de pagamentos ideal para a sua loja, aumentando a aprovação das vendas e reduzindo custos de tecnologia e de taxas, a partir das diversas opções de provedores e antifraude que oferecemos, potencializando os resultados do seu negócio.

Confira o passo a passo para a configuração do conector Malga e os recursos disponíveis para a sua loja:

​

Recursos do Conector Malga para lojas VTEX

Recurso	Suporte do conector
Suporte a pagamento por Pix, cartão de crédito e boleto	✅
Tokenização de cartão	✅
Certificado PCI compliance	✅
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 VTEX	✅
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	✅

​

Configuração do conector Malga VTEX​

O conector Malga está disponível no painel de Administração da sua loja VTEX, em configurações de Pagamentos, Afiliações de Gateways > Outros.

Para realizar a ativação do conector, você precisará das chaves de Application Key e Application Token, que são criadas pelo time da Malga e enviadas ao administrador da conta. Acione o nosso atendimento através do email suporte@malga.io para a configuração das chaves, que devem ser inseridas nesta tela:

​

Criação da sua conta Malga

Após o recebimento da sua solicitação através do email suporte@malga.io, nosso time irá criar a sua conta na Malga e realizar as seguintes etapas:

1. Criação de Subconta Malga

   1. Na subconta (merchant-id), são validadas as credenciais dos provedores de pagamento e de antifraude que você irá utilizar nas cobranças da sua loja. Confira as opções disponíveis nesta documentação;

   2. Caso você já possua conta em provedores, nosso time irá solicitar as chaves para a configuração da subconta com estas credenciais;

   3. Caso você necessite de cotação de taxas e abertura de conta em provedores, você também conta como o nosso suporte;

   4. A subconta criada na Malga deverá ser de uso exclusivo na sua loja Vtex, para rastreamento das cobranças através do Painel da loja e do Dashboard Malga. Avise nosso time caso precise uma subconta adicional para utilização do Link de Pagamento ou em outras plataformas;

   5. Você poderá consultar os provedores e métodos de pagamento configurados na sua subconta após a criação da sua conta de usuário no Dashboard Malga, através do menu de Subcontas;

2. Geração e envio das chaves VTEX

A partir da subconta criada, será gerado um par de chaves para utilização da Malga na sua loja VTEX, correspondendo ao Application Key e Application Token, que serão enviadas ao email do administrador responsável pela loja.

​

Configuração do conector na loja VTEX

1. Inserção das chaves na VTEX e ativação do conector | Afiliações de Gateways

No painel da sua loja VTEX, acesse a área de Configurações da Loja > Pagamentos > Configurações, selecionando a Malga nas opções de Afiliações de Gateways, e realize as seguintes etapas:

• Adicione o par de chaves Application Key e Application Token enviados pela Malga, nos respectivos campos;

• Selecione a opção “Use o Comportamento Recomendado pelo Processador de Pagamentos” no campo de configuração de Captura automática de pagamento;

• Selecione a opção “Live/produção” junto ao Nome da afiliação para realizar a ativação do conector;

• Clique em Salvar;

​

Configuração das Condições de Pagamento na loja VTEX

Após ativar o conector Malga nas Afiliações de Gateways, acesse o menu de Condições de Pagamento, para realizar as configurações de cada método de pagamento da loja. O conector Malga VTEX suporta cobranças nos métodos de crédito, pix e boleto, e devem ser configurados conforme as instruções:

Condições de pagamento > Método Boleto Bancário

Acessando o método Boleto Bancário, dentro da área de Condições de Pagamento e realize as seguintes configurações:

• No campo “Processar com a afiliação”, selecione Malga;

• Defina o status “Ativa”

• Configure as condições comerciais do método de acordo com a política da sua loja (vencimento, nome, condição);

• Clique em “Salvar”;

• Acesse as Condições de pagamento, em Boleto Bancário e defina a Malga como padrão caso já possua outra afiliação configurada;

• Pronto! As mudanças podem demorar até 10 minutos para estar refletidas na loja;

Condições de pagamento > Método Pix

Dentro do menu de Condições da Pagamento, acesso a opção Pagamento Instantâneo > PIX e realize as seguintes configurações:

• No campo “Processar com a afiliação”, selecione Malga;

• Defina o status “Ativa”;

• Configure as condições comerciais do método de acordo com a política da sua loja (vencimento, nome, condição);

• Clique em “Salvar”;

• Acesse as Condições de pagamento, em Pix e defina a Malga como padrão caso já possua outra afiliação configurada;

• Pronto! As mudanças podem demorar até 10 minutos para estar refletidas na loja;

Condições de pagamento > Método Cartão de Crédito

Os pagamentos por cartão de crédito devem ser configurados para cada Bandeira de cartão, conforme o exemplo:

Após selecionar a Bandeira, realize as seguintes etapas de configuração:

• No campo “Processar com a afiliação”, selecione Malga;

• Defina o status “Ativa”;

• Configure as condições comerciais do método de acordo com a política da sua loja para pagamentos à vista e parcelado;

• Clique em “Salvar”;

• Acesse as Condições de pagamento e defina a Malga como padrão caso já possua outra afiliação configurada;

• Pronto! As mudanças podem demorar até 10 minutos para estar refletidas na loja;

​

➡️ Recursos adicionais Malga

​

Fluxo inteligente de pagamentos através do Dashboard

Além do acompanhamento das cobranças realizadas na sua loja VTEX pelo Dashboard Malga, também é possível fazer alterações e configurações nas regras de processamento do seu fluxo inteligente de pagamentos sem a necessidade de fazer edições nas configurações da loja.

Através do menu Fluxos Inteligentes, você poderá adicionar, excluir e editar provedores do seu fluxo com total autonomia, e também utilizar os condicionais para distribuir as cobranças conforme as características mais interessantes para o seu negócio, como valor e parcelamento.

Saiba mais nesta documentação: Fluxos Inteligentes no Dashboard Malga | Malga

​

Identificação dos pagamentos da loja VTEX no Dashboard Malga

Para acessar o Dashboard Malga, você deverá realizar o seu cadastro através deste link e avisar o nosso time através do email suporte@malga.io. Após concluir o cadastro, você terá acesso ao ambiente sandbox e iremos liberar acesso ao ambiente de produção da sua conta e empresa, onde poderá consultar as cobranças processadas da loja VTEX pela Malga e os detalhes do pagamentos nos provedores, além dos outros recursos do Administrador de conta na Malga.

O identificador único dos pedidos da loja VTEX na Malga é ID do Pedido. Acessando o menu Pedidos > Todos os pedidos, você poderá visualizar a listagem de pedidos da sua loja e copiar o número de pedido para encontrar a cobrança no Dashboard Malga [filtro ID do pedido], conforme ilustrado nas imagens:

Para identificação dos pagamentos no Dashboard Malga, você poderá consultar a área de Cobranças. Clicando em uma cobrança específica, irá visualizar os IDs correspondentes em Detalhe de cobrança: no campo Pedido (ID do Pedido) e campo Descrição (VTEX Transaction ID), conforme a imagem:

​

Relatórios & dados

Para facilitar a análise da performance das cobranças processadas na Malga através do conector VTEX, disponibilizamos as seguintes ferramentas com dados e informações:

• Exportação das cobranças - disponibilização de arquivo .csv com a listagem e detalhes das cobranças através do Dashboard;

• Painel de Dados - painel com a visão gerencial da loja e informações sobre as cobranças autorizadas, perdidas, taxa de aprovação geral e por provedor, distribuição das vendas por método de pagamento e principais motivo de perda de transações;

• Analytics API - serviço que disponibiliza os dados dos pagamentos, clientes e processamento, desenvolvido em linguagem de consulta GraphQL, com um ambiente de testes e alto desempenho e flexibilidade para a realização de consultas;