Pix na fatura do WHMCS, com QR code, copia e cola e 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 lê o QR code ou copia o código na própria fatura, paga em segundos e a fatura é baixada sozinha ao confirmar o pagamento.

Comprar o módulo

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

• Pagamento em segundos. O cliente lê o QR code ou usa o copia e cola na própria fatura e paga na hora
• Baixa automática. Quando o Pix é confirmado, a fatura correspondente é quitada sozinha pela verificação periódica de status, sem conferência manual
• Copia e cola em um clique. O código Pix aparece na fatura com botão de copiar, 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 email: a tag {$gip_pix_html} coloca o QR Code e o Pix Copia e Cola no próprio email da fatura. O Pix é gerado na hora do envio, sem o cliente precisar abrir a fatura
• Página do Pix com a sua marca: a tag {$gip_pix_link} leva a uma página responsiva com a logo da empresa, o valor, o QR Code, o botão de copiar e a confirmação automática do pagamento na própria página
• Multa e juros após o vencimento, calculados pela iugu (multa de até 2% e juros de 1% ao mês)
• Painel do Pix na fatura do admin: copiar o Pix Copia e Cola, copiar o link da página do Pix para enviar ao cliente e abrir a cobrança na iugu
• Dados de quem pagou na fatura do admin (nome, CPF/CNPJ e identificador do Pix), com alerta quando o pagador é diferente do cliente
• 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

• 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/gipd/ e descompacte. Será criada a pasta gofasiugupix.
2. Copie as pastas includes e modules de dentro de gofasiugupix para a raiz da instalação do WHMCS, mesclando com as pastas existentes. O arquivo includes/hooks/gofasiugupix.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 Pix".
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 novas cobranças Pix
• 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 Pix
• Dias até o vencimento: prazo da cobrança 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 Pix é paga separadamente à iugu, conforme o plano da sua conta
• O cron do WHMCS precisa estar ativo. É ele que verifica o status das cobranças, dá baixa nas faturas pagas e revalida a licença
• Sem licença ativa, as cobranças já geradas continuam válidas e as baixas em andamento seguem funcionando. O módulo apenas deixa de gerar novas cobranças 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 das cobranças em aberto, na quantidade que você configurar e quita no WHMCS as faturas cujos Pix foram pagos.

O cliente precisa sair da fatura para pagar?

Não. O QR code e o copia e cola aparecem na própria fatura. O cliente lê ou copia e paga pelo aplicativo do banco.

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 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 - #23 bug

Correções:

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

Melhorias:

• Versão 2.1.0: Pix no email, página do Pix com a sua marca, multa e juros e dados do pagador - #21 enhancement

Melhorias:

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

Melhorias:

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

Melhorias:

• chamadas à API da iugu sem timeout podem travar o WHMCS inteiro - #18
• Publicar download PHP 8.1 (ionCube 14) para o gip no WHMCS live - #16
• Padronizar sanitização de telefone: remover DDI +55, zero à esquerda e validar comprimento - #14

Correções:

• 401 Unauthorized na criação de Pix: iugu passou a exigir Assinatura RSA - #17 bug

Melhorias:

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

Melhorias:

• v2.0.0: consolidação do callback e ajustes internos - #13
• Converter para módulo pago (verificação de licença + ionCube + produto WHMCS) - #12
• readme: link de suporte para o forum do proprio modulo - #11
• readme: contador do site, captura sem aviso de hook e secao de licenca - #10
• readme: captura versionada, badges e sumario - #9
• readme: conteudo da pagina do site transferido e captura de configuracao - #8

Correções:

• Fatal error add_hook() indefinido no callback (index.php:1412) quando notificação iugu chega sem invoice_id - #5 bug

Melhorias:

• Remover variante de codigo para PHP 7.4 (indexd.php / includesd) - #7
• Telemetria com consentimento (v1.1.0) - #6

Correções:

• Corrige valor quando crédito é adicionado à fatura - #4 bug

Correções:

• Adaptação para php 7 (evita erro ao resetar a senha) - #3 bug

Melhorias:

• Lançamento 🎉 - #2 enhancement good first issue