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.

Comprar o módulo

• 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

• Novas tentativas diárias: quando a cobrança no cartão salvo é recusada, o módulo tenta de novo uma vez por dia, em horário comercial, por até 10 dias depois do vencimento. Complementa as tentativas semanais do WHMCS e recupera pagamentos de cartões com limite momentaneamente esgotado
• Cartão salvo para cobranças automáticas, sem guardar os dados do cartão no seu servidor
• 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 ou superior, com cURL
• 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)

1. Baixe o arquivo em https://gofas.net/gicd/ e descompacte. Será criada a pasta gofasiugucartao.
2. Copie as pastas includes e modules de dentro de gofasiugucartao para a raiz da instalação do WHMCS, mesclando com as pastas existentes. O arquivo includes/hooks/gofasiugucartao.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 Cartão".
4. 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.

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

Correções:

• Número do cartão e token de pagamento aparecem no console do navegador - #19 bug

Melhorias:

• Versão 2.1.0: novas tentativas diárias no cartão salvo - #18 enhancement

Melhorias:

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

Melhorias:

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

Melhorias:

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

Melhorias:

• tokenização falha e o módulo segue com token inválido, sem informar o motivo - #14
• erro da iugu concatenado como string quando vem em array - #13
• Publicar download PHP 8.1 (ionCube 14) para o gic no WHMCS live - #12

Melhorias:

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

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