Configurações do Plugin WooCommerce iugu 3.1+
Receba pagamentos por cartão de crédito, boleto bancário, Pix e/ou Carnê em sua loja WooCommerce com a iugu.
Este plugin é um facilitador de integração para os clientes que utilizam WooCommerce e que estão utilizando a iugu como gateway de pagamento.
Sua finalidade é auxiliar na cobrança de vendas pontuais ou recorrentes, oferecendo os métodos de pagamento por: Cartão de Crédito, Boleto Bancário, PIX e/ou Carnê.
Sobre a versão 3.1.12 do plugin WooCommerce iugu:
A nova versão do plugin foi lançada oficialmente em 22/08/2024!
Caso utilize alguma versão anterior à esta, desative-a e faça a instalação da nova versão através do link).
Pré-requisitos do WooCommerce para utilizar o Plugin:
- Wordpress 5.6+
- PHP 7.2 +
- Woocommerce 5.1 +
- Brazilian Market on WooCommerce: permite enviar dados do cliente como CPF ou CNPJ, além dos campos número e bairro do endereço.
- WooCommerce Subscriptions 3.1.4+: para pagamentos recorrentes/assinaturas.
Pré-requisitos da iugu para utilizar o Plugin:
- Ter os métodos de pagamento habilitados
- Estar com a conta verificada
- Ter token API
- Ter o id da conta
Obs.: Somente siga os passos abaixo se estiver com os pré-requisitos corretamente configurados em seu ambiente Wordpress.
Verifique se todos os métodos de pagamento que irá utilizar estão habilitados em seu portal iugu. Para isso, acesse sua conta e clique em:
Cartão de Crédito: Configurações >> Cartão de crédito (link aqui)
É necessário que seja solicitada a verificação para uso no caso de cartão de crédito, enviando algumas documentações, acesse aqui para solicitar.
Boleto: Configurações >> Boleto bancário (link aqui)
PIX: Configurações >> PIX (link aqui)
Para verificação da conta, entre em contato com o nosso suporte. Para acessar o id da conta iugu e gerar token de API, acesse aqui.
Instalação do Plugin
1. Faça download do arquivo .zip do plugin clicando aqui
2. Acesse seu ambiente admin do Wordpress e clique em Plugins > Adicionar novo plugin/Add New > Enviar/Upload Plugin
3. Clique em Escolher arquivo e insira o arquivo .zip do plugin da iugu. Em seguida, clique em Instalar
Obs.: caso a instalação seja feita pelo próprio WordPress, o passo 3 não é necessário. Basta clicar em Instalar e em seguida Ativar. (Versão atual do plugin ainda não está disponível na loja do Wordpress)
4. Após finalizar a instalação, clique em Activate Plugin
Configurando métodos de pagamento no Plugin
Para habilitar o plugin da iugu e realizar as configurações iniciais, siga as orientações abaixo:
1. Acesse a opção configurações/settings dentro de WooCommerce, e então acesse a aba IUGU
2. Insira o Account ID, localizado em seu painel da iugu
3. Insira o API Token (Produção ou Teste)
4. Defina o Status for Pending Payment
5. Defina o Status for Payment Confirmation
6. Defina o Status for Partial Payment with Payment Booklets
7. Apenas habilite a opção iugu sandbox, caso o Token de API seja o de testes
8. É bem importante habilitar a opção de Depuração. Esta opção registra todos os logs gerados pelo plugin da iugu, com o intuito de facilitar a identificação de possíveis erros
9. Para finalizar, clique em Save changes
Atenção
Utilize apenas o Token de Testes, para realizar transações teste antes de disponibilizar sua loja em Produção, também é necessário selecionar a opção iugu sandbox.
Habilitando os métodos de pagamento
Clique na aba Pagamentos/Payments dentro das opções de configurações/settings do Woocommerce
Em seguida, habilite os métodos de pagamento desejados, clicando nos botões que ficam abaixo de Activado/Enabled
Configurações personalizadas para Cartão de Crédito
1. Dentro da aba Pagamentos/Payments clique em Gerir/Manage ao lado de iugu – Credit card para configurá-lo
2. Caso deseje realizar configurações personalizadas, segue abaixo algumas informações importantes:
- Ignorar e-mail devido (Ignore due email): opção para não enviar e-mails de cobrança ao pagador
- Menor valor da parcela (Smallest installment value): opção para limitar o valor mínimo de cada parcela (esse valor não pode ser menor que 5). A opção de parcelamento no produto/serviço deve estar habilitada
- Passe no interesse (Uses interest in installments): opção de repasse dos juros ao pagador (informação é apresentada no checkout como “com juros” ou “sem juros”, e informa também os cálculos que serão aplicados os juros)
- Envie apenas o total do pedido (Send only the order total): opção que apresenta o valor total do pedido, mas não a lista de itens comprados
Ao final da configuração personalizada, clique em Guardar alterações
Configurações personalizadas para Boleto Bancário
1. Dentro da aba Pagamentos/Payments clique em Gerir/Manage ao lado de iugu – Bank slip para configurá-lo
2. Caso deseje realizar configurações personalizadas, segue abaixo algumas informações importantes:
- Ignorar e-mail devido (Ignore due email): opção para não enviar e-mails de cobrança ao pagador
- Habilitar desconto de Boleto (Enable Bank Slip Discount): opção que habilita desconto para clientes que optarem por esta forma de pagamento
- Tipo de Desconto (Discount Type): opção que define se a cobrança terá um desconto fixo ou desconto em percentual
- Valor de desconto (Discount value): opção que define o valor do desconto
- Prazo de pagamento padrão (Default payment deadline): opção que define o prazo para vencimento do boleto
- Envie apenas o total do pedido (Send only the order total): opção que apresenta o valor total do pedido, mas não a lista de itens comprados
Ao final da configuração personalizada, clique em Guardar alterações
Configurações personalizadas para PIX
1. Dentro da aba Pagamentos/Payments clique em Gerir/Manage ao lado de iugu – PIX para configurá-lo
2. Caso deseje realizar configurações personalizadas, segue abaixo algumas informações importantes:
- Ignorar e-mail devido (Ignore due email): opção para não enviar e-mails de cobrança ao pagador
- Envie apenas o total do pedido (Send only the order total): opção que apresenta o valor total do pedido, mas não a lista de itens comprados
Ao final da configuração personalizada, clique em Guardar alterações
Configurações personalizadas Carnê
1. Dentro da aba Pagamentos/Payments clique em Gerir/Manage ao lado de iugu – Payment Booklets para configurá-lo
2. Caso precise realizar configurações personalizadas, segue abaixo algumas informações importantes:
- Ignorar e-mail devido (Ignore due email): opção para não enviar e-mails de cobrança ao pagador
- Número de parcelas (Number of Installments): opção que configura o parcelamento máximo de um carnê
- Prazo de Pagamento (Default payment deadline): opção que configura o período que o cliente terá para realizar o primeiro pagamento
- Aceita pagamento em PIX (Accepts installment payment with PIX): opção que disponibiliza no Carnê, o QrCode do PIX, junto com o boleto bancário
- Menor valor da parcela (Smallest installment value): opção para limitar o valor mínimo de cada parcela (esse valor não pode ser menor que 5). A opção de parcelamento no produto/serviço deve estar habilitada
- Utiliza juros parcelados (Uses interest in installments): opção que configura o repasse de juros ao pagador
Ao final da configuração personalizada, clique em Guardar alterações
Atenção!
Antes de disponibilizar sua loja em Produção, para vendas reais, verifique se a chave API configurada na aba IUGU, dentro das configurações do Woocommerce, está com a chave de Teste e também, se a opção Sandbox iugu está selecionada.
Caso esteja com a chave de teste e a opção selecionada, remova a seleção e substitua a chave pela chave API de Produção.
Updated 2 months ago