Pular para o conteúdo principal

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

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

Vtex Payment Configuration
Configurações de pagamentos no painel VTEX > Afiliações de gateways > Outros > Malga
Vtex Gateway Configuration
Configurações de pagamentos no painel VTEX > Afiliações de gateways

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 (merchant)

    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.

SEGURANÇA

Por medida de segurança, recomendamos a exclusão do email com as chaves após a inserção no painel da sua loja VTEX. Avise o nosso time através do email suporte@malga.io, caso precise de um novo par de chaves ou realizar a exclusão das chaves criadas anteriormente;

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ções de pagamentos no painel VTEX
Configurações de pagamentos no painel VTEX > Afiliações de gateways
Captura automática de pagamentos
Painel VTEX > Afiliações de gateways > Captura automática de pagamentos
info

Após esta etapa, o conector Malga VTEX estará ativo nas suas Afiliações de Gateways, porém ainda não configurado para processar pagamentos da loja. Para finalizar a integração, siga para a próxima etapa e realize a configuração das Condições de Pagamento com o conector.

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 Boleto Bancário
Condições de pagamento > Método Boleto Bancário
Condições de pagamento > Método Boleto Bancário
Condições de pagamento > Método Boleto Bancário
Condições de pagamento > Método Boleto Bancário > Padrão
Condições de pagamento > Método Boleto Bancário > Padrão
Condições de pagamento > Método Boleto Bancário > Padrão > Malga definida como Padrão
Condições de pagamento > Método Boleto Bancário > Padrão > Malga definida como Padrão

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 Pix
Condições de pagamento > Método Pix
Condições de pagamento > Método Pix > Malga
Condições de pagamento > Método Pix > Malga

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:

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

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;

Vtex Detalhes da Charge DashboardVtex
Fluxo inteligente de Pagamento Malga > Condicional de Balanceador
Vtex Detalhes da Charge DashboardVtex
Condições de pagamento > Cartão de Crédito > Bandeira American Express > Malga como Padrão
info

Com a ativação do conector Malga nas Afiliações de Gateways e a configuração das condições de pagamento com a afiliação Malga como PADRÃO para cada método e bandeiras de cartão, a sua loja estará processando cobranças através de nosso conector.

Importante: Só é possível utilizar uma afiliação padrão por método e bandeira, podendo desativá-la se necessário através do menu de Condições de pagamento;

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

Vtex Detalhes da Charge DashboardVtex
Fluxo inteligente de Pagamento Malga > Condicional de Balanceador
FLUXO INTELIGENTE MALGA

É possível utilizar todos os condicionais do fluxo Malga (valor, balanceador, moeda, parcelas, bandeira e número do cartão), realizando as configurações pelo Dashboard, exceto o condicional de campo personalizado que não é enviado na cobrança processada pela loja VTEX;

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:

Vtex Detalhes da Charge DashboardVtex
Loja VTEX > Todos os pedidos > ID do pedido
Vtex Detalhes da Charge DashboardVtex
Dashboard Malga > Cobranças > Busca por ID do pedido

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:

Vtex Detalhes da Charge DashboardVtex
Dashboard Malga > Cobranças > Detalhe de cobrança
Vtex Detalhes da Charge DashboardVtex
Detalhe de cobranças na loja VTEX > ID da transação
Vtex Detalhes da Charge DashboardVtex
Cobranças na loja VTEX
ESTORNO / CAPTURA DE COBRANÇAS

As operações de captura e estorno parcial ou total devem ser realizados pelo painel da loja VTEX, onde você pode cancelar parte do pedido ou dos itens adquiridos na compra. Receberemos sua solicitação através da nossa integração e faremos a requisição de estorno no provedor de pagamento responsável pelo pagamento e a respectiva atualização do status da cobrança no Dashboard Malga;

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;

Vtex Painel de Dados

SUPORTE MALGA

Acione o nosso time de atendimento através do email suporte@malga.io para acompanhar a configuração do conector na sua loja VTEX e também na utilização do Dashboard e demais produtos Malga.