Se você está sofrendo com algum comportamento inesperado no seu site WordPress enquanto utiliza o nosso plugin WooCommerce iugu, é possível que algum dos seus plugins sofram conflitos com o nosso, principalmente, os que têm como finalidade, a modificação estética (templates) do seu site.

Além disso, há alguns comportamentos que podem ser corrigidos com pequenos ajustes em suas configurações.

Pré-requisitos

Aqui estão os requisitos mínimos para utilizar o plugin da iugu no WordPress:

WooCommerce

• WordPress 5.6+
• PHP 7.2+
• WooCommerce 5.1+
• Plugin Brazilian Market on WooCommerce (permite enviar dados como CPF ou CNJP, além dos campos número e bairro do endereço)
• WooCommerce Subscriptions

iugu

• Ter os métodos de pagamento habilitados. Saiba mais.
• Conta iugu verificada. Saiba mais.
• Possuir o api_token (test ou live). Saiba mais.
• Possuir o account_id da conta iugu. Saiba mais.

Erros

Aqui estão alguns dos erros mais comuns mapeados e sugestões de como solucioná-los.

Método de Pagamento é inválido

1. Se você tem o plugin Shopengine e/ou Shopengine Pro instalado, desative-o e verifique se o erro persiste.
2. Na aba Geral das Configurações, certifique-se que a moeda seja "Real Brasileiro (R$) — BRL".

Mensagem "Há um erro crítico no seu site"

Se você tem o plugin TW WhatsApp Chat Rotator instalado, desative-o e verifique se o erro persiste.

Tradução não funciona

Acesse a pasta raiz do WordPress e apague os arquivos que começam com o iugu- presentes na pasta wp-content\languages\plugins.

Parcelamento não funciona

Se você deseja oferecer a opção de parcelamento para os seus clientes mas este recurso não está funcionando, siga as instruções a seguir.

Habilite "Parcelas" no Alia

Para isso, siga o passo a passo:

1. Acesse alia.iugu.com
2. Configurações > Cartão de Crédito
3. Verifique e marque a caixa de seleção "Parcelas"
4. Determine o número máximo de parcelas (2 a 12)
5. Clique em Salvar.

No plugin WooCommerce iugu

Acesse as configurações do plugin > Pagamentos > iugu — Credit Card > Gerenciar e informe o número máximo de parcelas em "Quantidade de Parcelas".

🚧

Menor ou igual

Informe um valor menor ou igual ao inserido na etapa 4.

Parcelas por produto

Se, mesmo após as etapas anteriores, ainda não estiver com as parcelas disponíveis, verifique se você utiliza Parcelamento por produto e se essas parcelas estão configuradas no produto em questão:

1. Acesse as configurações do plugin
2. Produtos > localize o produto > clique na aba IUGU
3. Número de parcelas > informe o número máximo de parcelas deste produto.

Erro ao excluir cliente

Este comportamento é presente apenas nas versões mais antigas. Certifique-se de atualizar para a versão 3.1.11.

Pedido com status pago na iugu e pendente no WooCommerce

Esse comportamento ocorre quando o plugin da iugu não consegue criar a URL de gatilho no painel da iugu. Para isto, é preciso:

1. Acesse alia.iugu.com
2. Configurações > Comunicação via Gatilhos
3. Verifique se há algum gatilho com a URL https://dominio_do_site/wp-admin/admin-ajax.php?action=wc_iugu_notification_handler

Se não, provavelmente, o motivo seja a alteração na versão do plugin da iugu (atualize-o aqui) ou firewall ativado.

Como solucionar

1. No WordPress, acesse as Configurações do WooCommerce
2. Clique na aba IUGU > apenas clique em Salvar alterações
3. Verifique se o gatilho foi criado.

Se não, verifique se o seu Firewall está bloqueando o IP da iugu 54.207.210.151.

Mensagem invoices: Array

Se a mensagem invoices: Array é exibida no checkout após efetuar o pagamento, siga as etapas abaixo:

1. Em seu WordPress > WooCommerce > Checkout Fields
2. Verifique e altere a opção Display Person Type para Individuals and Legal Person.

Faça um novo teste com um cliente novo. Não utilize um e-mail de um cliente que já existe nesta conta. De preferência, utilize a aba anônima do seu navegador.

Obter ajuda

Se ainda precisar de ajuda, entre em contato com Suporte Técnico.