Skip to content

Módulo iugu Cartão para WHMCS

versão downloads abrir issue

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

Sumário

Por que usar

  • 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

Funcionalidades

  • 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

A caixa de cartão na área do cliente

Cliente informando os dados do cartão na fatura do WHMCS

Requisitos

  • 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)

Instalação

  1. Baixe o arquivo em https://gofas.net/gicd/ e descompacte. Será criada a pasta gofasiugucartao.
  2. Copie a pasta modules de dentro de gofasiugucartao 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 Cartão".
  4. Informe a chave de licença, o ID da conta e os tokens da API.

Configuração

Opções do módulo

  • 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

Informações importantes

  • 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

Perguntas frequentes

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.

Changelog

Veja changelog.md.

Suporte

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

Licença

Contrato de licença de uso

Changelog

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

Comparar versões

Melhorias:

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

Vale mencionar:

Comparar versões

Comparar versões

Scroll To Top