> For the complete documentation index, see [llms.txt](https://docs.iopay.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iopay.com.br/products/modulos-para-ecommerce/wordpress-woocommerce.md).
# 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.