Boleto registrado no checkout do WHMCS, com baixa automática.

O WHMCS cuida dos seus clientes, faturas e serviços. A iugu processa a cobrança. Este módulo une os dois: o cliente gera o boleto na própria fatura, paga e a fatura é baixada sozinha, sem conferência de extrato nem baixa manual.

Comprar o módulo

• Por que usar
• Funcionalidades
• Requisitos
• Instalação
• Configuração
• Informações importantes
• Perguntas frequentes
• Changelog
• Suporte
• Licença

• Boleto na própria fatura. O cliente gera o boleto direto na fatura do WHMCS, sem sair do seu site
• Baixa automática. Quando o boleto é pago, a fatura correspondente é quitada sozinha pela verificação periódica de status, sem conferência manual
• Copiar em um clique. A linha digitável e o Pix copia e cola do boleto ficam com botão de copiar na fatura, facilitando o pagamento pelo celular
• No seu tempo. Dias até o vencimento, valor mínimo e mensagem na fatura configuráveis
• Testes sem risco. O ambiente sandbox da iugu valida todo o fluxo antes de ir para produção

• Pix no boleto: o mesmo boleto também pode ser pago com Pix, com baixa na hora. A fatura e o email mostram o QR Code e o Pix Copia e Cola
• Boleto no email: a tag {$gib_boleto_html} coloca a linha digitável, o botão do PDF e o Pix do boleto no próprio email da fatura. O boleto é gerado na hora do envio
• Multa e juros após o vencimento, calculados pela iugu (multa de até 2% e juros de 1% ao mês)
• Painel do boleto na fatura do admin: copiar a linha digitável e o Pix, abrir o PDF e a cobrança na iugu; quando pago com Pix, mostra quem pagou, com alerta quando o pagador é diferente do cliente
• Boleto registrado gerado via API iugu, integrado ao checkout nativo do WHMCS
• Copia e cola da linha digitável e do Pix do boleto na fatura, com 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 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

• WHMCS 8.x ou superior
• PHP 8.2 ou superior, com cURL
• ionCube Loader 15 ou superior
• Cron do WHMCS ativo, para a verificação de status e a revalidação da licença
• Conta iugu com API habilitada (token de produção e de testes)

1. Baixe o arquivo em https://gofas.net/gibd/ e descompacte. Será criada a pasta gofasiuguboleto.
2. Copie as pastas includes e modules de dentro de gofasiuguboleto para a raiz da instalação do WHMCS, mesclando com as pastas existentes. O arquivo includes/hooks/gofasiuguboleto.php ativa os recursos que rodam no cron do WHMCS.
3. Ative o módulo em Configurações > Portais para Pagamentos, na aba Todos os Portais de Pagamento, clicando em "Gofas iugu Boleto".
4. Informe a chave de licença e os tokens da API.

• Chave de licença: obtida ao adquirir o módulo. Sem licença ativa o módulo não gera novos boletos
• 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 > Registros do Módulo
• Valor mínimo: valor mínimo da fatura para permitir pagamento via boleto
• Dias até o vencimento: prazo do boleto a partir da emissão
• Mensagem na fatura: texto exibido ao cliente na fatura
• Verificação de status: horário de execução e quantidade de faturas verificadas por requisição
• Enviar estatísticas de uso: telemetria identificada opcional

• A tarifa do boleto é paga separadamente à iugu, conforme o plano da sua conta
• O cron do WHMCS precisa estar ativo. É ele que verifica o status dos boletos, dá baixa nas faturas pagas e revalida a licença
• Sem licença ativa, os boletos já gerados continuam válidos e as baixas em andamento seguem funcionando. O módulo apenas deixa de gerar novos boletos até a licença ser regularizada
• Sempre faça backup antes de alterar qualquer coisa no seu sistema
• Personalizações podem ser feitas sem editar o código original, via hooks, mantendo o módulo atualizável

A baixa da fatura é automática?

Sim. A cada rodada do cron o módulo consulta na iugu o status dos boletos em aberto, na quantidade que você configurar e quita no WHMCS as faturas cujos boletos foram pagos.

Posso testar antes de cobrar de verdade?

Sim. Com o Sandbox ligado e o token de testes, todo o fluxo roda no ambiente de testes da iugu, sem gerar cobrança real.

O que acontece se a licença ficar inativa?

Os boletos já gerados continuam válidos e as baixas em andamento seguem funcionando. O módulo apenas deixa de gerar novos boletos até a licença ser regularizada.

O histórico de versões fica no final desta página.

Abra um tópico no fórum do módulo. Para enviar código ou logs, use um link do Gist (gist.github.com) ou do Pastebin (pastebin.com).

Contrato de licença de uso

Correções:

• Ativação do zero falha com Gateway Module Not Activated - #39 bug

Correções:

• Mensagem da fatura exibe
  em vez da quebra de linha - #38 bug

Melhorias:

• Versão 2.1.0: Pix no boleto, boleto no email, multa e juros e painel no admin - #37 enhancement

Melhorias:

• Atualização importante de segurança - #36

Melhorias:

• fix: require no topo do index.php impede a declaração de _config e quebra a ativação - #35

Melhorias:

• chamadas à API da iugu sem timeout podem travar o WHMCS inteiro - #34
• Padronizar sanitização de telefone: remover DDI +55, zero à esquerda e validar comprimento - #26

Melhorias:

• linha digitável ausente na primeira exibição e botão oculto em sandbox - #33

Melhorias:

• migrar a emissão do boleto de /v1/charge para /v1/invoices - #32
• número e logradouro do pagador extraídos errado de address1 - #31
• bank_slip_extra_days calculado como subtração de datas em YYYYMMDD - #30
• Publicar download PHP 8.1 (ionCube 14) para o gib no WHMCS live - #29
• link: falha silenciosa quando a iugu retorna HTTP 200 com success:false - #28

Correções:

• Boleto com vencimento errado (data distante) em faturas manuais geradas antes do vencimento - #18 bug

Melhorias:

• v2.0.1: chave de licença lida cifrada, phone_home sem admin_url/admin_path e module_version desatualizada - #27

Melhorias:

• Converter para módulo pago (verificação de licença + ionCube + produto WHMCS) - #25
• 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

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

Melhorias:

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

Correções:

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

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

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

Melhorias:

• Lançamento - #1 enhancement good first issue