Cartão de crédito no checkout do WHMCS, à vista ou parcelado, sem guardar o cartão no seu servidor.
O WHMCS cuida dos seus clientes, faturas e serviços. A iugu processa o pagamento. Este módulo une os dois: o cliente informa o cartão na interface nativa do WHMCS, paga na hora, e a fatura é confirmada, sem que os dados do cartão passem pelo seu servidor.
- Por que usar
- Funcionalidades
- Requisitos
- Instalação
- Configuração
- Informações importantes
- Perguntas frequentes
- Changelog
- Suporte
- Licença
- Pagamento na hora. O cliente paga com cartão dentro da própria fatura do WHMCS e a confirmação é imediata
- Sem guardar cartão. Os dados do cartão vão direto para a iugu. Seu servidor não armazena número nem CVV, reduzindo o escopo de segurança
- À vista ou parcelado. Você habilita o parcelamento, define o valor mínimo e o número máximo de parcelas
- Interface nativa. Usa a tela de cartão de crédito do próprio WHMCS, sem redirecionar o cliente para fora
- Testes sem risco. O ambiente sandbox da iugu valida todo o fluxo antes de ir para produção
- Checkout nativo de cartão de crédito do WHMCS
- Pagamentos à vista ou parcelados, com valor mínimo e número máximo de parcelas configuráveis
- Não armazena dados de cartão no seu servidor
- Valor mínimo da fatura para permitir pagamento com cartão
- 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 revalidação da licença
- Conta iugu com API habilitada (ID da conta e tokens de produção e de testes)
- Baixe o arquivo em https://gofas.net/gicd/ e descompacte. Será criada a pasta
gofasiugucartao. - Copie a pasta
modulesde dentro degofasiugucartaopara a raiz da instalação do WHMCS, mesclando com as pastas existentes. - Ative o módulo em
Configurações > Portais para Pagamentos, na aba Todos os Portais de Pagamento, clicando em "Gofas iugu Cartão". - Informe a chave de licença, o ID da conta e os tokens da API.
- Chave de licença: obtida ao adquirir o módulo. Sem licença ativa o módulo não processa novos pagamentos
- ID da Conta na iugu: identificador da sua conta iugu
- 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 com cartão
- Permitir parcelamento: exibe as opções de parcelamento na fatura quando aplicável
- Valor mínimo para parcelamento: valor mínimo da fatura para permitir parcelamento
- Máximo de parcelas: número máximo de parcelas oferecidas ao cliente
- Enviar estatísticas de uso: telemetria identificada opcional
- A tarifa do cartão é paga separadamente à iugu, conforme o plano da sua conta
- Os dados do cartão são enviados direto para a iugu. O seu servidor não armazena número nem CVV
- O cron do WHMCS precisa estar ativo, pois é ele que revalida a licença
- Sem licença ativa, o módulo deixa de processar novos pagamentos 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
Os dados do cartão ficam no meu servidor?
Não. O cliente digita o cartão na interface nativa do WHMCS e os dados são enviados direto para a iugu. Seu servidor não armazena número nem CVV.
Posso oferecer parcelamento?
Sim. Ligue Permitir parcelamento e defina o valor mínimo da fatura para parcelar e o número máximo de parcelas. As opções aparecem para o cliente na fatura quando aplicável.
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/
Melhorias:
- v2.0.0: consolidação do callback e ajustes internos - #9
- Converter para módulo pago (verificação de licença + ionCube + produto WHMCS) - #8
- readme: link de suporte para o forum do proprio modulo - #7
- readme: contador do site, captura sem aviso de hook e secao de licenca - #6
- readme: captura versionada, badges e sumario - #5
- readme: conteudo da pagina do site transferido e captura de configuracao - #4
Melhorias:
- Remover variante de codigo para PHP 7.4 (indexd.php / includesd) - #3
- Telemetria com consentimento (v1.1.0) - #2
Vale mencionar:
- Lançamento v1.0.0 - #1
good first issue

