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 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

​

Conector Malga VTEX​

O conector Malga está disponível no painel de Administração da sua loja VTEX, em configurações de Pagamentos > Provedores. Para realizar a ativação do conector, você precisará do par de chaves de Token de aplicação e Chave de aplicação, 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;

​

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: 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 já possua conta em provedores, nosso time irá solicitar as chaves para a configuração da subconta com estas credenciais;
3. Caso 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;

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 (chave e token de aplicação), 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 | Provedores

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

• Adicione o par de chaves Application Key e Application Token enviados pela Malga, nos respectivos campos;
• Define um Nome para a conexão com a Malga;
• Utilize a opção de “Ativar modo teste”, caso queira realizar transações de teste utilizando a Malga;
• Em “Liquidação Automática”, selecione a opção “Use o Comportamento Recomendado pelo Processador de Pagamentos”, que neste caso irá capturar as cobranças em até 7 dias após sua ocorrência. Caso tenha dúvida sobre esta configuração ou necessite de captura imediata, converse com nosso time para que possamos orientá-lo sobre a configuração;
• Clique em Salvar;

​

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

Após ativar o conector Malga na área de Provedores, acesse o menu de Configurações > 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:

​

Pagamento > Boleto Bancário

Busque pelo método Boleto Bancário, dentre as opções de Condições de Pagamento e realize as seguintes configurações:

• No campo “Processar com o provedor” e 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 possua outro provedor configurado;
• Pronto! As mudanças podem demorar até 10 minutos para estar refletidas na loja;

​

Pagamento > Pix

Busque por Pix nas opções de Condições da Pagamento e realize as seguintes configurações:

• No campo “Processar com o provedor” e 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 possua outro provedor configurado;
• Pronto! As mudanças podem demorar até 10 minutos para estar refletidas na loja;

​

Pagamento > 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 o provedor” e 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 outro provedor configurado;
• Pronto! As mudanças podem demorar até 10 minutos para estar refletidas na loja;

​

Recursos adicionais Malga VTEX

​

Fluxo Inteligente no 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 na 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;