Módulo iugu Pix para WHMCS

Gera cobranças Pix via API da iugu, com código QR exibido diretamente na fatura do WHMCS e baixa automática ao confirmar o pagamento. Desenvolvido pela Gofas Software, é 100% gratuito e de código aberto.

Sumário

Download
Funcionalidades
Requisitos
Instalação
Configuração
Informações importantes
Suporte
Licença

Download

Baixar a versão mais recente

Funcionalidades

Código QR Pix na fatura, com copia e cola em um clique
Verificação periódica de status configurável: horário de execução e quantidade de faturas verificadas por requisição
Baixa automática das faturas quando o Pix é pago
Valor mínimo da fatura para permitir pagamento via Pix
Dias até o vencimento configuráveis
Mensagem personalizada exibida na fatura
Suporte a produção e a testes (sandbox)
Logs de diagnóstico configuráveis
Aviso de atualização e verificação de versão na própria tela de configuração do módulo

Requisitos

WHMCS >= 7.9
PHP >= 8.1
Conta iugu com API habilitada (token de produção e de testes)

Instalação

Baixe o arquivo pelo link de download e descompacte. Será criada a pasta gofasiugupix.
Copie a pasta modules de dentro de gofasiugupix para a raiz da instalação do WHMCS, mesclando com as pastas existentes.
Ative o módulo em Opções > Pagamentos > Portais para Pagamentos > aba All Payment Gateways, clicando em "Gofas iugu - Pix".
Informe os tokens da API.

Configuração

Opções do módulo

API token produção: token de produção da sua conta iugu.
API token teste: token de testes da sua conta iugu.
Sandbox: alterna entre o ambiente de testes e produção.
Salvar Logs: grava informações de diagnóstico em Utilitários > Logs > Log de Módulo.
Valor mínimo: valor mínimo da fatura para permitir pagamento via Pix.
Dias até o vencimento: prazo da cobrança Pix gerada.
Mensagem na fatura: texto exibido na fatura, acima do código QR.
Horário da verificação: horário em que o módulo verifica o status das cobranças.
Verificações por requisição: número máximo de faturas consultadas por vez.
Enviar estatísticas de uso (opcional): controla o envio identificado das estatísticas de confirmação de pagamento. Desmarcado, as confirmações continuam sendo contabilizadas de forma anônima.

Informações importantes

A tarifa do Pix é paga separadamente à iugu, conforme o plano da sua conta.
Sempre faça backup antes de mudar algo no seu sistema.

Suporte

Abrir issue no fórum do módulo.

Licença

O código deste módulo é público para transparência e auditoria. Isso não transfere a titularidade nem concede licença livre de uso: o software é de propriedade da Gofas Software, protegido pela Lei 9.609/98 e pelos tratados de direitos autorais.

Trechos do contrato de licença de uso que se aplicam diretamente a este repositório:

Não redistribuir: é proibido o aluguel, o arrendamento, o empréstimo, a cessão e o licenciamento do software a terceiros, total ou parcial, assim como o fornecimento de serviços de hospedagem comercial do software (Cláusula 10ª, §3º).
Não modificar: é vedado qualquer procedimento que implique engenharia reversa, descompilação, desmontagem, tradução, adaptação ou modificação do software, bem como qualquer alteração não autorizada de suas funcionalidades (Cláusula 10ª, §2º).
Módulo alterado perde o suporte: a Gofas não se responsabiliza por defeitos decorrentes de alteração do software, de operação por pessoas não autorizadas ou da integração com softwares de terceiros (Cláusula 10ª, §7º). O suporte é uma cortesia e não é garantido pela licença (Cláusula 7ª, §1º).