# WordPress / WooCommerce
**Instalando o checkout transparenteIOPAY no WooCommerce**
Guia para a instalação de todos os componentes necessários para utilizar o plugin do IOPAY para WooCommerce.
Vamos lá:
### Brazilian Market on WooCommerce
O primeiro plugin que precisa ser instalado — e que é um requisito básico — chama-se Brazilian Market on WooCommerce. Ele é necessário por conta dos campos obrigatórios de Customer, como CPF, Endereço e Telefone, que a API IOPAY pede no momento da criação de uma transação.
Para instalar esse plugin é necessário acessar o Painel Wordpress > Plugins > Adicionar Novo. Em seguida, digite no campo de pesquisa, no canto superior direito o seguinte: Brazilian Market on WooCommerce. Veja esses passos na imagem a seguir
Excelente! Como mostra o passo, clique no botão "Instalar agora", neste primeiro resultado do lado esquerdo. O processo de instalação deve demorar alguns segundos — assim que ele for finalizado, clique em "Ativar".
Este módulo gera alguns campos que são de envio obrigatório para a API na hora da finalização da transação. São eles:
Campos de cobrança, será usado para entrega se o de entrega não for fornecido
| Nome | Id |
| ------------------- | --------------------- |
| Primeiro nome: | billing\_first\_name |
| Último nome: | billing\_last\_name |
| CPF: | billing\_cpf |
| Sexo: | billing\_sex |
| Data de Nascimento: | billing\_birth\_date |
| Telefone: | billing\_phone |
| Celular: | billing\_cellphone |
| E-mail: | billing\_email |
| Rua: | billing\_address\_1 |
| Número: | billing\_number |
| Complemento: | billing\_address\_2 |
| Bairro: | billing\_neighborhood |
| Cidade: | billing\_city |
| Estado: | billing\_state |
| País: | billing\_country |
| CEP: | billing\_postcode |
Campos de entrega, se não for fornecido, será usado o de cobranca
| Primeiro nome: | shipping\_first\_name |
| ------------------- | ---------------------- |
| Último nome: | shipping\_last\_name |
| Sexo: | shipping\_sex |
| Data de Nascimento: | shipping\_birth\_date |
| Telefone: | shipping\_phone |
| Celular: | shipping\_cellphone |
| E-mail: | shipping\_email |
| Rua: | shipping\_address\_1 |
| Número: | shipping\_number |
| Complemento: | shipping\_address\_2 |
| Bairro: | shipping\_neighborhood |
| Cidade: | shipping\_city |
| Estado: | shipping\_state |
| País: | shipping\_country |
| CEP: | shipping\_postcode |
###
### Instalando o Plugin de Pagamentos IOPAY para Woocommerce
O próximo passo é instalar o plugin da IOPAY para WooCommerce. Para isso você deve seguir os seguintes passos:
1 - Você deve baixar o arquivo woocommerce-IOPAY-X.X.X.zip da última versão do módulo
2 - Acessar o menu Plugins > Adicionar Novo em seu painel admin do wordpress.
3 - Nesta mesma página, clique em Enviar Plugin > Browse...:
4 - Após fazer o upload do arquivo, você deve clicar em Instalar agora.
5 - Após isso, poderá ativar o módulo da IOPAY em sua loja e então fazer suas configurações:
Pronto! O plugin IOPAY para WooCommerce está instalado no seu WooCommerce. Assim que esse plugin é ativado, você é direcionado à página de configuração dos plugins, que é nosso próximo passo.
**Configurando o Plugin IOPAY**
Agora que você já tem o plugin instalado no seu WooCommerce, vamos então configurar este complemento para aceitar transações por Boleto, Cartão de crédito e PIX.
### Configurações de Boleto bancário
Primeiro é preciso que você encontre o plugin IOPAY. Faça isso em: Plugins > Plugins Instalados > WooCommerce IOPAY e clique em Configurações de boleto, assim como é mostrado nos passos 1 de 3:
Ao clicar em Configurações de boleto, a tela a seguir é mostrada. É preciso configurar esses campos, então veja o que cada um significa e como fazer isso nas explicações abaixo.
### Explicando os campos da imagem acima:
#### Habilitar/Desabilitar:
Ativa ou desativa a opção de oferecer o boleto do IOPAY na sua página de finalização de pedido.
#### Ativar Sanbox IOPAY:
Ativa ou desativa a opção de testes junto a IOPAY
#### Título:
Neste campo é necessário indicar o nome que será mostrado para a opção de Boleto bancário na página de finalização de compra no seu site.
#### Descrição:
Ao lado do título você pode também fornecer uma descrição para esta opção, também na página de finalização de compra no seu site.
#### E-mail Auth:
Neste campo você deve colocar seu e-mail da API IOPAY.
#### IO\_SELLER\_ID:
Neste campo você coloca a sua IO\_SELLER\_ID, que é uma chave utilizada para autenticar o seu negócio junto à API do IOPAY.
#### SECRET
Preste atenção sempre em qual chave você está usando, se é a de teste ou a de produção.
#### Log de depuração:
Habilita a opção de que eventos sejam registrados em um arquivo de Log. Isso é essencial para investigar possíveis questões que interfiram no funcionamento do plugin.
Uma vez inseridas todas essas informações, agora é só clicar em Salvar alterações para que o boleto do IOPAY esteja habilitado em sua loja.
### Configurações de Cartão de crédito
Assim como na configuração anterior, para fazer as alterações de Cartão você precisa seguir o caminho: Plugins > Plugins Instalados > WooCommerce IOPAY e então clicar em Configurações de Cartão de crédito, como mostra a imagem abaixo:
Ao clicar em Configurações de Cartão de crédito, a tela a seguir é mostrada. É preciso configurar esses campos, então veja o que cada um significa e como fazer isso nas explicações abaixo.
Explicando os campos da imagem acima:
#### Habilitar/Desabilitar:
Ativa ou desativa a opção de pagamento com Cartão de crédito na sua página de finalização de pedido.
#### Ativar Sanbox IOPAY:
Ativa ou desativa a opção de testes junto a IOPAY
#### Título:
Neste campo é necessário indicar o nome que será mostrado para a opção de Cartão de crédito na página de finalização de compra no seu site.
#### Descrição:
Ao lado do título você pode também fornecer uma descrição para esta opção, também na página de finalização de compra no seu site.
#### E-mail Auth:
Neste campo você deve colocar seu e-mail da API IOPAY.
#### IO\_SELLER\_ID:
Neste campo você coloca a sua IO\_SELLER\_ID, que é uma chave utilizada para autenticar o seu negócio junto à API do IOPAY.
#### SECRET
Preste atenção sempre em qual chave você está usando, se é a de teste ou a de produção.
#### Número de parcelas:
Este campo define em até quantas vezes será possível parcelar um pedido.
#### Valor da menor parcela:
Caso queira, você pode definir um valor mínimo para as parcelas de compras feitas no seu site. O módulo mostra sempre o maior número até que o valor seja atingido. Por exemplo: Um produto A tem um valor de R$100,00, mas foi configurado no módulo que a parcela mínima seria R$70,00, então a única opção disponível é o pagamento à vista.
#### Taxa de juros:
O módulo IOPAY oferece a conveniência de calcular (via juros simples) o valor das parcelas de acordo com um valor de juros passado neste campo. Configure este valor usando ponto, e não vírgula. Caso a sua aplicação não cobre juros, é preciso deixar o campo como 0.
#### Antifraude:
Se voce contratou o plano antifraude, deixe esse campo marcado, atençao se ficar desmarcado e voce utiliza o plano, o sistem ficara com erro.
#### Parcelas sem juros:
Alinhado diretamente com o ponto de juros, esta opção define em até quantas parcelas aquele pedido não será cobrado juros. Exemplo: Digamos que o campo esteja configurado com 3, ou seja, caso o cliente opte por comprar em 1x, 2x ou 3x, seu pedido não será cobrado juros, mas caso escolha 4x, todas as parcelas terão juros aplicados.
#### Log de depuração:
Habilita a opção de que eventos sejam registrados em um arquivo de Log. Isso é essencial para investigar possíveis questões que interfiram no funcionamento do plugin.
Agora tudo o que precisa ser feito é clicar em "Salvar Alterações" e a sua loja estará pronta para transacionar com a opção de Cartão de crédito do IOPAY. Viu como é simples?
### Configurações do PIX
Primeiro é preciso que você encontre o plugin IOPAY. Faça isso em: Plugins > Plugins Instalados > WooCommerce IOPAY e clique em Configurações de PIX, assim como é mostrado nos passos 1 de 3:
Ao clicar em Configurações de PIX, a tela a seguir é mostrada. É preciso configurar esses campos, então veja o que cada um significa e como fazer isso nas explicações abaixo.
### Explicando os campos da imagem acima:
#### Habilitar/Desabilitar:
Ativa ou desativa a opção de oferecer o boleto do IOPAY na sua página de finalização de pedido.
#### Ativar Sanbox IOPAY:
Ativa ou desativa a opção de testes junto a IOPAY
#### Título:
Neste campo é necessário indicar o nome que será mostrado para a opção de Boleto bancário na página de finalização de compra no seu site.
#### Descrição:
Ao lado do título você pode também fornecer uma descrição para esta opção, também na página de finalização de compra no seu site.
#### E-mail Auth:
Neste campo você deve colocar seu e-mail da API IOPAY.
#### IO\_SELLER\_ID:
Neste campo você coloca a sua IO\_SELLER\_ID, que é uma chave utilizada para autenticar o seu negócio junto à API do IOPAY.
#### SECRET
Preste atenção sempre em qual chave você está usando, se é a de teste ou a de produção.
#### Log de depuração:
Habilita a opção de que eventos sejam registrados em um arquivo de Log. Isso é essencial para investigar possíveis questões que interfiram no funcionamento do plugin.
Uma vez inseridas todas essas informações, agora é só clicar em Salvar alterações para que o boleto do IOPAY esteja habilitado em sua loja.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.iopay.com.br/products/modulos-para-ecommerce/wordpress-woocommerce.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.