Configurações do Plugin WooCommerce iugu 3.1+

Receba pagamentos por cartão de crédito, boleto bancário e Pix na 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 recorrência, oferecendo os métodos de pagamento por: Cartão de Crédito, Boleto Bancário e PIX.

❗️

Sobre a versão 3.1.5 do plugin WooCommerce iugu:

A nova versão do plugin foi lançada oficialmente em 26/09/2023!
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

Passo 1: Faça download do arquivo Zip do plugin clicando aqui.
Passo 2: Acesse seu ambiente admin do Wordpress e clique em Plugins > Add New > Upload Plugin.

Passo 3: Clique em “Escolher arquivo” e insira o 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 disponível na loja do Wordpress)

Passo 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 os passos abaixo:

1. Acesse a aba IUGU dentro da opção Woocommerce
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 também o Status for Payment Confirmation
6. Apenas habilite a opção iugu sandbox, caso o Token de API seja o de testes
7. É 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
8. Para finalizar, clique em Save changes

🚧

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 Payments dentro das opções de configuração do Woocommerce:
Em seguida, clique no botão que fica abaixo de Enabled para habilitar os métodos de pagamento que utilizará

Configurações personalizadas para Cartão de Crédito

Passo 1: Dentro da aba Payments clique em Manage ao lado de iugu – Credit card para configurá-lo

Passo 2: Caso deseje realizar configurações personalizadas, segue abaixo algumas informações:
Ignorar e-mail devido (Ignore due email): Quando marcado, não enviaremos ao pagador e-mails de cobrança.
Menor valor da parcela (Smallest installment value): esta opção, você poderá limitar o valor mínimo de cada parcela quando habilitado a opção de parcelamento no produto/serviço.
Passe no interesse (Uses interest in installments): opção de repasse dos juros para o pagador (Informação é apresentada no checkout como “com juros” ou “sem juros” e informa também o cálculo que serão aplicados os juros)
Envie apenas o total do pedido (Send only the order total): se selecionado, apenas apresenta o valor total do pedido e não a lista de itens comprados .

Configurações personalizadas para Boleto Bancário

Passo 1: Dentro da aba Payments clique em Manage ao lado de iugu – Bank slip para configurá-lo

Passo 2: Caso deseje realizar configurações personalizadas, segue abaixo algumas informações:
Ignorar e-mail devido (Ignore due email): quando ativado, Iugu não enviará e-mails de cobrança ao pagador.
Habilitar desconto de Boleto (Enable Bank Slip Discount): opção para habilitar a aplicação de desconto no pagamento.
Tipo de Desconto (Discount Type): opção para definir se será desconto fixo ou desconto em Percentual.
Valor de desconto (Discount value): campo para definir o valor do desconto.
Prazo de pagamento padrão (Default payment deadline): prazo para vencimento do pagamento do boleto.
Envie apenas o total do pedido (Send only the order total): apresenta somente o valor total do pedido, não a lista de itens comprados.

Configurações personalizadas para PIX

Passo 1: Dentro da aba “Payments” clique em “Manage” ao lado de “iugu – PIX” para configurá-lo

Passo 2: Caso deseje realizar configurações personalizadas
Ignorar e-mail devido (Ignore due email): Quando marcado, não enviaremos ao pagador e-mails de cobrança.
Envie apenas o total do pedido (Send only the order total): se selecionado, apenas apresenta o valor total do pedido e não a lista de itens comprados.
Ao final da configuração personalizada, clique em Salvar.

🚧

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.