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

# WooCommerce

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 <div className="check-icon" id={id}>
      <Icon icon={iconType} iconType="regular" color={foundColor} size={18} />
    </div>;
};

Através da instalação e ativação do plugin Malga para Woocomerce, você tem disponível uma interface pronta para integração para realizar cobranças por cartão de crédito, pix e boleto sem ter que desenvolver uma linha de código. Basta conectar na sua loja e começar a utilizar a Malga e todos os recursos dos [fluxos inteligentes](/documentations/flow-guide/introduction) de pagamento e funcionalidades para gestão financeira através do [Dashboard Malga](https://dashboard.malga.io/) e da [Analytics API](/analytics/intro).

### Recursos do plugin da Malga

| Recurso                                                                  | Suporte do plugin                         |
| ------------------------------------------------------------------------ | :---------------------------------------- |
| Cartão de Crédito, Pix e Boleto                                          | <CheckIcon type="check" mode="success" /> |
| Outros métodos (NuPay, Drip, Voucher)                                    | -                                         |
| Tokenização de cartão                                                    | -                                         |
| PCI compliance                                                           | <CheckIcon type="check" mode="success" /> |
| Suporta todos os provedores de pagamento suportados pela Malga           | <CheckIcon type="check" mode="success" /> |
| Suporta antifraude                                                       | <CheckIcon type="check" mode="success" /> |
| Suporta fluxo inteligente de pagamentos com envio de campo personalizado | <CheckIcon type="check" mode="success" /> |
| Suporta split de pagamentos                                              | -                                         |
| Validação de cartões (Zero Dollar)                                       | <CheckIcon type="check" mode="success" /> |
| Estorno e captura de cobranças pelo Dashboard Malga                      | <CheckIcon type="check" mode="success" /> |
| Exportar cobranças pelo Dashboard                                        | <CheckIcon type="check" mode="success" /> |

## Getting started

### 1. Crie uma conta Malga

A **criação da conta na Malga** é uma etapa fundamental para utilização dos serviços e configuração dos provedores e métodos habilitados no seu fluxo de pagamentos. Ela é realizada pelo nosso time, e com ela, você terá acesso às credenciais de <code>client-id</code> e <code>api-key</code> necessárias para o setup e terá a sua primeira [subconta](https://dashboard.malga.io/app/merchants) (merchant) criado para processar cobranças.

<Info>
  Entre em contato conosco pelo e-mail{" "}
  <a href="mailto:suporte@malga.io">[suporte@malga.io](mailto:suporte@malga.io)</a> 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
  [documentação](/api-reference/type-tables/payment-methods-by-providers).
</Info>

Para começar a processar pagamentos através da Malga, você deve ter uma conta criada.

### 2. Instale e ative o Plugin

1. Faça o [download](https://malga-docs-prod.s3.amazonaws.com/files/WooCommerce+Payments.zip) do plugin Malga;
2. No [painel](https://wordpress.com/home), acesse [Plugins](https://wordpress.com/plugins/) e clique no botão Fazer upload na parte superior direita;
3. Clique para encontrar o local do arquivo .zip no seu computador ou o arraste para a caixa. *Não descompacte o arquivo antes de fazer o upload;*
4. O plugin será automaticamente instalado e ativado no seu site. Depois, basta clicar no botão **Gerenciar plugin** para acessar as opções;
5. Além do **plugin Malga**, é necessário ter o **plugin** [Brazilian Market on WooCoommerce](https://wordpress.org/plugins/woocommerce-extra-checkout-fields-for-brazil/) instalado para transacionar com o plugin da Malga. Caso não esteja instalado, o nosso plugin solicitará que você instale-o e realize a ativação do plugin.

### 3. Configure o plugin para realizar cobranças

Através do painel de administração da sua loja na [Woocommerce](https://wordpress.com/home), selecione “Configurações” no plugin da Malga ou acesse as configurações de pagamento. Siga as etapas descritas abaixo:

1. Insira as credenciais de <code>client-id</code> e <code>api-key</code> Malga nas configurações do plugin;
2. Você pode utilizar o nosso ambiente de sandbox para testar as suas transações. Para isso, [crie sua conta no Dashboard Malga](https://dashboard.malga.io/sign-up), as chaves para testes estarão disponíveis na tela inicial do painel, após a conclusão do cadastro;
3. Também é possível escolher e atribuir uma chave para configuração de [Webhooks](/documentations/webhooks/webhook1-1). Após escolher essa chave, o nosso plugin retornará o endereço URL para que você receba as notificações;
4. Para determinar o nome do estabelecimento que vai aparecer na fatura do cartão do seu cliente para descrever a compra feita, basta preencher o campo do **Statement Descriptor**;
5. Para configurar os **métodos de pagamento**, selecione as formas de pagamento que deseja oferecer aos seus clientes entre cartão de crédito, boleto e PIX;
6. Para o método de pagamento boleto, é possível escolher quantos dias para **expiração do boleto**, preenchendo as instruções, formato, valor e dias para cobrança de juros e multa;
7. Para configurar o antifraude, você deve entrar na aba **WooCommerce -> Configurações -> Pagamentos -> Malga -> Assinalar a opção “Utilizar FraudAnalysis”;**
8. Após completar a configuração, salve as alterações, e sua loja estará pronta para processar pagamentos através da Malga! 🚀

### 4. Configuração adicional para otimização do fluxo de pagamentos

O plugin Malga para Woocommerce também suporta o **envio de metadata na cobrança, para ser utilizada como parâmetro condicional no fluxo inteligente de pagamentos.**

Confira mais detalhes em nossa documentação sobre o [enviar dados adicionais personalizados (metadata)](/documentations/flow-guide/introduction#uso-de-metadados-de-transacao), para serem utilizados como regra e condicional para orquestração do fluxo, conforme exemplo a baixo:

```php theme={null}
function example_metadata( $metadata, $order, $post  ) {
    foreach ( $order->get_items() as $item_id => $item ) {
		if($item->get_name() == 'test'){
			$metadata['cnpj'] = '123';
		}
	}
    return $metadata;
}
add_filter( 'malga_payment_flow', 'example_metadata', 10, 3 );
```

### 5. Configuração adicional para otimização do fluxo de pagamentos

Além de melhorar os resultados da sua loja através do plugin Malga, você tem à disposição todos os recursos da nossa infraestrutura para gerenciar sua operação:

* [Fluxos Inteligentes](https://dashboard.malga.io/app/smart-flows) - através do qual você poderá adicionar, excluir e editar provedores do seu fluxo com total autonomia pelo Dashboard Malga, 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;
* [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;
* [Webhooks](/documentations/webhooks) - utilize o serviço de webhooks Malga para notificar o seu sistema sobre os eventos ocorridos na nossa plataforma. Através de webhooks, você consegue atualizar seu sistema sempre que um evento importante acontece, como a atualização de status de uma cobrança para confirmar ou cancelar um determinado pagamento.
