Ir para o conteúdo

Módulo iugu Boleto para WHMCS

versão downloads abrir issue

Gera, consulta e dá baixa automática em boletos bancários via API da iugu, integrado ao checkout nativo do WHMCS. Desenvolvido pela Gofas Software, é 100% gratuito e de código aberto.

Sumário

Download

Baixar a versão mais recente

Funcionalidades

  • Boleto registrado gerado via API iugu, integrado ao checkout nativo do WHMCS
  • 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 boleto é pago
  • Valor mínimo da fatura para permitir pagamento via boleto
  • Dias até o vencimento configuráveis
  • Mensagem personalizada exibida na fatura
  • Redirecionamento para o boleto ao acessar a fatura (opcional)
  • 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

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

Configuração

Opções do módulo

Tela de configuracoes do modulo

  • 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 boleto.
  • Dias até o vencimento: prazo do boleto gerado.
  • Mensagem na fatura: texto exibido na fatura, acima do botão do boleto.
  • Redirecionar para o Boleto: redireciona o cliente direto ao boleto ao acessar a fatura.
  • Horário da verificação: horário em que o módulo verifica o status dos boletos.
  • 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 boleto é 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º).

Changelog

Melhorias:

  • readme: link de suporte para o forum do proprio modulo - #24
  • readme: contador do site, captura sem aviso de hook e secao de licenca - #23
  • readme: captura versionada, badges e sumario - #22
  • readme: conteudo da pagina do site transferido e captura de configuracao - #21

Comparar versões

Melhorias:

  • Remover variante de codigo para PHP 7.4 (indexd.php / includesd) - #20
  • Telemetria com consentimento (v1.3.0) - #19

Correções:

  • Evita erro getGatewayVariables not defined na área do cliente - #17 bug

Comparar versões

Comparar versões

Melhorias:

  • Resolvido o erro "gateway functions not found" no cadastro - #16

Comparar versões

Correções:

  • Descontos aplicados à fatura considerados como números positivos - #15 bug

Comparar versões

Melhorias:

  • Exibe nas configurações do módulo data e hora da última verificação de versão - #14 enhancement
  • Diretório raíz do WHMCS agora é obtido via banco de dados a consultando o diretório do template ativo (para casos onde localizações relativas podem falhar) - #13 enhancement
  • Carrega configurações e variáveis personalizadas incluídas nos arquivos /custom/config.php e /custom/params.php - #11 enhancement
  • Checa a instalação do hook e alerta no topo das configurações quando o arquivo não é localizado - #10 enhancement
  • Botão "Verificar atualizações" nas configurações reseta a informação local e verifica a versão mais recente disponível - #9 enhancement

Comparar versões

Melhorias:

  • Redução no número de pastas e arquivos do módulo - #8 enhancement
  • Nova opção: Máximo de boletos verificados a cada consulta de status de pagamento realizada na API iugu - #6 enhancement
  • Nova opção: Horário da verificação - #5 enhancement
  • Adicionada compatibilidade com PHP 7 e 8 - #4 enhancement
  • Atualização dos links para a documentação - #3 enhancement
  • Atualiza o registro de versão ao registrar confirmação de pagamento - #2 bug enhancement

Comparar versões

Melhorias:

Comparar versões

Role para cima