# Barte para WooCommerce

Integre sua loja WooCommerce com o **gateway de pagamento Barte** e aceite pagamentos por **cartão de crédito**, **PIX** e **boleto bancário** de forma simples e segura.

> 💡 Este plugin oficial conecta sua loja diretamente à Barte, automatizando o processamento e atualização de pedidos.

***

### Baixar Plugin

<a href="https://barte-docs-vueedny7.manus.space/WooCommerceGatewayBarte.zip" class="button primary" data-icon="download">Baixar Plugin v1.0.0</a>

***

### <i class="fa-gear">:gear:</i> Requisitos

Antes de instalar o plugin, verifique se o ambiente da sua loja atende aos seguintes requisitos:

* **WordPress** 6.4.3 ou superior
* **WooCommerce** 8.8.0 ou superior
* **Conta ativa na Barte**
  * Crie sua conta em [www.barte.com](https://www.barte.com)
* **WooCommerce Extra Checkout Fields for Brazil** *(recomendado)*
  * Necessário para envio de **CPF/CNPJ** nos pagamentos via PIX e Boleto

***

### <i class="fa-rocket">:rocket:</i> Instalação do Plugin

1. **Acesse o menu Plugins**\
   No painel administrativo do WordPress, clique em **Plugins** no menu lateral esquerdo.<br>

   <figure><img src="https://barte-docs-vueedny7.manus.space/step1-plugins-menu.png" alt=""><figcaption></figcaption></figure>

2. **Clique em “Adicionar novo”**\
   Na página de Plugins, clique no botão **Adicionar novo** localizado no topo da página.

<figure><img src="https://barte-docs-vueedny7.manus.space/step2-add-new-plugin.png" alt=""><figcaption></figcaption></figure>

3. **Clique em "Enviar Plugin"**\
   No topo da página, clique no botão **Enviar plugin** para fazer upload do arquivo ZIP.

<figure><img src="https://barte-docs-vueedny7.manus.space/step3-upload-plugin.png" alt=""><figcaption></figcaption></figure>

4. **Selecione o arquivo e instale**\
   Clique em **Escolher arquivo**, selecione o arquivo `WooCommerceGatewayBarte.zip` que você baixou e clique em **Instalar agora**.\ <br>

   <figure><img src="https://barte-docs-vueedny7.manus.space/step4-choose-file.png" alt=""><figcaption></figcaption></figure>

5. **Ative o plugin**\
   Após a instalação bem-sucedida, clique no botão **Ativar plugin** para habilitar o plugin em sua loja.<br>

<figure><img src="https://barte-docs-vueedny7.manus.space/step5-activate-plugin.png" alt=""><figcaption></figcaption></figure>

***

### <i class="fa-gears">:gears:</i> Configuração do Plugin

1. **Acesse as configurações do WooCommerce**\
   No menu lateral, expanda o menu **WooCommerce** e clique em **Configurações**.

<figure><img src="https://barte-docs-vueedny7.manus.space/step6-woocommerce-settings.png" alt=""><figcaption></figcaption></figure>

2. **Acesse a aba Pagamentos**\
   Na página de configurações do WooCommerce, clique na aba **Pagamentos** para gerenciar os métodos de pagamento.

<figure><img src="https://barte-docs-vueedny7.manus.space/step7-payments-tab.png" alt=""><figcaption></figcaption></figure>

3. **Localize e configure o método Barte**\
   Na lista de métodos de pagamento, localize **Barte**, ative o método usando o toggle e clique em **Gerenciar** para configurar.

<figure><img src="https://barte-docs-vueedny7.manus.space/step8-barte-payment.png" alt=""><figcaption></figcaption></figure>

4. **Configure o X-Token-Api**\
   Insira o **X-Token-Api** que você obteve no painel da Barte. Para obter sua chave API:
   1. Acesse o painel da Barte em [www.barte.com](https://www.barte.com/)
   2. Navegue até **Configurações → Integrações → Chaves API**
   3. Gere uma nova chave ou copie uma existente
   4. Cole a chave no campo **X-Token-Api** nas configurações do plugin

<figure><img src="https://barte-docs-vueedny7.manus.space/step9-api-token.png" alt=""><figcaption></figcaption></figure>

5. **Configure o Webhook**<br>

   O plugin exibirá uma URL de webhook que você precisa configurar no painel da Barte. Para configurar:

   1. Copie a URL de webhook exibida nas configurações do plugin
   2. Acesse o painel da Barte
   3. Navegue até **Configurações → Integrações → Webhooks**
   4. Crie uma nova entrada de webhook
   5. Cole a URL copiada do plugin
   6. Salve as configurações

   <figure><img src="https://barte-docs-vueedny7.manus.space/step10-webhook-url.png" alt=""><figcaption></figcaption></figure>

***

### <i class="fa-basket-shopping">:basket-shopping:</i> Métodos de Pagamento Disponíveis

|                   |                                                                                                         |
| :---------------: | :-----------------------------------------------------------------------------------------------------: |
|     **Método**    |                                              **Descrição**                                              |
| Cartão de Crédito |               Aceite pagamentos com as principais bandeiras com total segurança e rapidez.              |
|        PIX        |          Receba pagamentos instantâneos, com confirmação imediata e sem taxas para o comprador.         |
|  Boleto Bancário  | Ofereça uma alternativa tradicional para seus clientes, com geração automática e atualização de status. |

***

### <i class="fa-check">:check:</i> Conclusão

> Sua loja WooCommerce agora está integrada com a Barte!\
> Você pode acompanhar os pagamentos e status dos pedidos diretamente no painel do WordPress ou da Barte.