Skip to content

iugu/iugu_payment-gateway-woocommerce

Repository files navigation

Plugin Woocommerce Iugu

Este plugin é um facilitador de integração entre Woocommerce e Iugu.

Sua finalidade é auxiliar a cobrança de Vendas como compras pontuais ou Assinaturas, oferecendo os métodos de pagamento: Cartão de Crédito, Boleto Bancário e PIX.

Antes de utilizar veja nossos pré-requisitos para instalação:

  • Wordpress 5.6+
  • PHP 7.2 +
  • Woocommerce 5.1 +
  • Brazilian Market on WooCommerce
  • Woocomerce Subscriptions.

Obs.: Somente siga os passos abaixo se estiver com os pré-requisitos corretamente configurados em seu ambiente Wordpress Verifique também se todos os métodos de pagamento que irá utilizar estão habilitados em seu portal iugu**Cartão de Crédito** Por padrão, Boleto Bancário e PIX, já vem habilitado. Para o Cartão de Crédito, veja a seguinte documentação clicando aqui.

Instalando o plugin

Primeiro passo precisa realizar o download do arquivo Zip do plugin.

Em seguida, acesse seu ambiente admin do Wordpress, clique em Plugins> Add New> Upload Plugin:

image

Clique em “Escolher arquivo”, insira o Zip do plugin da iugu e clique em “Instalar”:

image

Após finalizar a instalação, clique em “Activate Plugin”:

image

Configurando Plugin Woocommerce Iugu:

Obs.: Para seguir com esta configuração, é preciso ter uma conta verificada na iugu, caso sua conta ainda não esteja verificada, solicite nossa ajuda direto no portal da iugu através de nosso chat.

Primeiro você precisará acessar seu portal iugu, para resgatar sua account_id e criar sua api_token, clique aqui e veja como fazer.

Em seguida, se atente a quais os meios de pagamento irá ativar para seu E-commerce.

É necessário realizar a configuração em cada um deles.

Dentro da opção “WooCommerce”, clique em “Settings” e em seguida clique em “Payments”:

image

Vamos iniciar com as configurações do método de pagamento Cartão de Crédito:

Acesse a opção “Settings”, dentro do menu de opções do “WooCommerce”.

Na próxima tela, clique em “Payments” e selecione a opção “Manage”, que fica no canto direito das informações do “iugu - Credit card”:

image

Na próxima tela, precisa habilitar a utilização do Cartão de crédito, selecionando a opção “Ativar pagamentos com cartão de crédito com iugu”.

Em seguida é preciso inserir o account_id e api_token (copiados do portal da iugu):

image

Abaixo há algumas opções personalizadas que podem ser configuradas:

image

Ignorar e-mail devido: Quando marcado, não enviaremos ao pagador e-mails de cobrança.

Menor valor da parcela: esta opção, você poderá limitar o valor mínimo de cada parcela quando habilitado a opção de parcelamento.

Passe no interesse: opção de repasse dos juros para o pagador (Informação é apresentada no checkout com “com juros” ou “sem juros” e informa também o cálculo que serão aplicados os juros)

Envie apenas o total do pedido: se selecionado, apenas apresenta o valor total do pedido e não a lista de itens comprados.

Sandbox iugu: usado para testar pagamentos. Não se esqueça de usar um token TEST API, que pode ser encontrado / criado nas configurações da conta iugu

Depurando: ativando esta opção, serão gravados todos os registros de evento iugu, como as solicitações de API. O registro pode ser encontrado em Status do sistema> registros

Por fim, clique em “Salvar alterações”:

image

Agora, habilite o método de pagamento Boleto Bancário:

Acesse a opção “Settings”, dentro do menu de opções do “WooCommerce”.

Na próxima tela, clique em “Payments” e selecione a opção “Manage”, que fica no canto direito das informações do “iugu - Bank slip”:

image

Assim como o meio de pagamento “cartão de crédito”, no “boleto bancário” também é preciso ativar o pagamento de boleto bancário e inserir as informações de account_id e api_token:

image

Para o método de pagamento Boleto Bancário, temos algumas configurações adicionais que dependem de seu modelo de negócio:

image

Ignorar e-mail devido - quando ativado, Iugu não enviará e-mails de cobrança ao pagador.

Habilitar desconto de Boleto - opção para habilitar a aplicação de desconto no pagamento.

Tipo de Desconto - opção para definir se será desconto fixo ou desconto em Percentual.

Valor de desconto - campo para definir o valor do desconto.

Prazo de pagamento padrão - prazo para vencimento do pagamento do boleto.

Envie apenas o total do pedido - apresenta somente o valor total do pedido, não a lista de itens comprados.

Sandbox iugu - usado para testes de pagamentos. É preciso utilizar o api_token de teste, gerando direto no portal nas configurações da conta iugu .

Após configurado e personalizado com seu modelo de negócio, é só salvar as alterações.

Para finalizar as configurações dos meios de pagamentos, habilite o método de pagamento PIX

Na próxima tela, clique em “Payments” e selecione a opção “Manage”, que fica no canto direito das informações do “iugu - PIX”:

image

Assim como os outros métodos de pagamento, é preciso inserir as informações de account_id e token_api e habilitar o método de pagamento:

image

O método de pagamento PIX, também há configurações personalizáveis:

image

Ignorar e-mail devido - quando ativado, Iugu não enviará e-mails de cobrança ao pagador.

Envie apenas o total do pedido - opção para apresentar ao cliente apenas o total do pedido e não apresentar a lista de itens comprados.

Sandbox iugu - usado para testes de pagamentos. É preciso utilizar o api_token de teste, gerando direto no portal nas configurações da conta iugu .

E para finalizar é só salvar as alterações.

Ativando a opção de “Assinaturas” nas configurações:

Caso utilize a opção de assinaturas, é preciso configurar também na aba “Assinaturas”, dentro das configurações do WooCommerce:

image

Selecione a opção “Habilitar assinaturas Iugu” e também configure a opção “Tipo de desconto de boleto bancário”:

image

Não se esqueça de salvar as alterações!