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

• 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 a 8.4, com cURL e 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 a pasta modules de dentro de gofasiugupix para a raiz da instalação do WHMCS, mesclando com as pastas existentes.
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.

Veja changelog.md.

Dúvidas, sugestões e problemas: https://gofas.net/contato/

Contrato de licença de uso

Melhorias:

• Publicar download PHP 8.1 (ionCube 14) para o gip no WHMCS live - #16

Comparar versões

Melhorias:

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

Comparar versões

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

Comparar versões

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

Comparar versões

Correções:

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

Comparar versões

Melhorias:

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

Comparar versões