> ## Documentation Index
> Fetch the complete documentation index at: https://malga-develop.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Conector VTEX
export const CheckIcon = ({mode, type, id}) => {
const colorIcons = {
'error': '#919191',
'success': '#00AE42',
'noSupported': '#919191'
};
const foundColor = colorIcons[mode];
const iconType = mode === 'noSupported' ? type : `circle-${type}`;
return
;
};
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](/api-reference/type-tables/payment-methods-by-providers) pela Malga | |
| Suporta [antifraude](/api-reference/type-tables/antifraude-providers) | |
| Suporta adição de condicionais no [fluxo inteligente](/documentations/flow-guide/flow-dash) 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](mailto:suporte@malga.io)** para a configuração das chaves;
Configurações de pagamentos no painel VTEX > Afiliações de gateways > Outros
> Malga
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](mailto: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](/api-reference/type-tables/payment-methods-by-providers);
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](/documentations/dashboard/payment-link) 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](https://dashboard.malga.io/app/merchants "https://dashboard.malga.io/app/merchants");
**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.
**SEGURANÇA** Por medida de segurança, recomendamos a exclusão do e-mail 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](mailto: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 | 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ções de pagamentos no painel VTEX > Afiliações de gateways
Painel VTEX > Afiliações de gateways > Captura automática de pagamentos
Após esta etapa, o conector Malga VTEX estará ativo nas suas Condições de Pagamento, 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 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;
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 > Malga definida
como Padrão
### **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;
Condições de pagamento > Método Pix
Condições de pagamento > Método Pix > Malga
### **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:
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 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;
Fluxo inteligente de Pagamento Malga > Condicional de Balanceador
Condições de pagamento > Cartão de Crédito > Bandeira American Express >
Malga como Padrão
Com a ativação do conector Malga em **Provedores** e **Condições de Pagamento** para cada método e bandeira de cartão, a sua loja estará processando cobranças através de nosso conector.
Importante: Na VTEX, só é possível utilizar um provedor para cada método e bandeira,
podendo ser alterado diretamente do menu de Condições de Pagamento;
## **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**](https://dashboard.malga.io/app/smart-flows "https://dashboard.malga.io/app/smart-flows"), 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](/documentations/flow-guide/flow-dash)
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 na Malga**
Para acessar o [Dashboard Malga](https://dashboard.malga.io/ "https://dashboard.malga.io/"), você deverá realizar o seu cadastro através [deste link](https://dashboard.malga.io/sign-up "https://dashboard.malga.io/sign-up") e avisar o nosso time através do email [suporte@malga.io](mailto: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:
Loja VTEX > Todos os pedidos > ID do pedido
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](https://dashboard.malga.io/app/charges "https://dashboard.malga.io/app/charges"). 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:
Dashboard Malga > Cobranças > Detalhe de cobrança
Detalhe de cobranças na loja VTEX > ID da transação
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](/documentations/dashboard/export-data) - disponibilização de arquivo .csv com a listagem e detalhes das cobranças através do Dashboard;
* [Painel de Dados](/documentations/dashboard/insights) - 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](/analytics/intro) - 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;
**SUPORTE MALGA** Acione o nosso time de atendimento através do email
[suporte@malga.io](mailto: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.
