Ir para o conteúdo
Parceria oficialEfí BankAbrir conta na Efí →

Módulo Efí Pix para WHMCS

versão downloads fóruns do Efí Pix

Receba por Pix instantaneamente, direto na sua conta Efí, as cobranças do WHMCS. O QR code e o copia e cola aparecem na própria fatura e a confirmação do pagamento é automática, em tempo real. Desenvolvido pela Gofas Software, é 100% gratuito.

Sumário

Download

Baixar a versão mais recente

O download é gratuito e exige cadastro no gofas.net. Quem ainda não tem conta é levado ao cadastro e, depois de confirmar o e-mail, faz login e baixa o módulo.

Funcionalidades

  • Pix no email: a tag {$gefip_pix_link} leva o cliente, direto do email da fatura, a uma página com a sua marca, o valor, o QR Code gerado na hora, o botão de copiar e a confirmação automática do pagamento
  • Painel do Pix na fatura do admin: copiar o Pix Copia e Cola e o link da página do Pix para enviar ao cliente por WhatsApp ou chat
  • Confirmação automática em tempo real do pagamento e baixa da fatura
  • QR code na fatura do WHMCS, sem redirecionamentos
  • Copia e cola do código Pix em um clique
  • Reemissão automática do QR code expirado
  • Chave Pix definida pelo administrador do WHMCS
  • Mensagem personalizada exibida na fatura
  • Valor mínimo da fatura para permitir pagamento via Pix
  • Cálculo da tarifa por transação confirmada, preenchendo o campo "Taxas" (fee) da lista de transações do WHMCS
  • Dispensa configuração de campos CPF/CNPJ: o módulo detecta automaticamente os campos personalizados de clientes
  • 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

Requisitos

  • WHMCS >= 8.0
  • PHP 8.2 ou superior
  • ionCube Loader 15 ou superior
  • Conta Efí (Efí Pay) com Pix habilitado
  • Credenciais: Client ID e Client Secret (produção e homologação)
  • Certificado .p12 convertido para .pem (produção e homologação)
  • Chave Pix aleatória cadastrada na conta Efí

Instalação

  1. Baixe o arquivo em https://gofas.net/gefipd/ e descompacte. Será criada a pasta gofasefipix.
  2. Copie as pastas includes e modules de dentro de gofasefipix para a raiz da instalação do WHMCS, mesclando com as pastas existentes. O arquivo includes/hooks/gofasefipix.php ativa o link do Pix nos emails e o painel na fatura do admin.
  3. Ative o módulo em Opções > Pagamentos > Portais para Pagamentos > aba All Payment Gateways.
  4. Informe as credenciais, os certificados e a chave Pix.

Configuração

Pré configuração na Efí

  1. Em API > Aplicações, crie uma aplicação e copie as credenciais Client ID e Client Secret geradas para produção e para homologação.
  2. Em API > Meus certificados, gere um certificado para produção e outro para homologação.
  3. Converta os certificados para o formato PEM (certificado e chave em um único arquivo):
openssl pkcs12 -in certificado.p12 -out certificado.pem -nodes -password pass:""
  1. Em Pix > Minhas chaves, cadastre uma chave aleatória para usar na configuração do módulo.

Pré configuração no WHMCS

Crie um campo personalizado de cliente para CPF e/ou CNPJ, ou dois campos distintos, um para cada documento. O módulo identifica os campos automaticamente. O CPF é obrigatório mesmo quando o cliente tem CNPJ no cadastro.

Opções do módulo

Tela de configuracoes do modulo

  • Chave Client ID Produção e Chave Client Secret Produção: credenciais da aplicação em modo produção.
  • Certificado Produção: caminho completo do arquivo .pem de produção, exemplo /var/www/site.com.br/certificado.pem.
  • Chave Client ID Desenvolvimento e Chave Client Secret Desenvolvimento: credenciais da aplicação em modo homologação.
  • Certificado Homologação: caminho completo do arquivo .pem de homologação.
  • Chave Pix: chave Pix aleatória registrada na sua conta Efí.
  • Sandbox: gera cobranças em modo de teste.
  • Salvar Logs: grava informações de diagnóstico em Utilitários > Logs > Log de Módulo.
  • Valor mínimo: valor mínimo da fatura para permitir pagamento via Pix. Formato decimal separado por ponto, exemplo 2.99.
  • Valor da tarifa Efí: percentual da comissão paga à Efí a cada transação confirmada, usado para preencher o campo "Taxas" (fee) da transação no WHMCS.
  • Mensagem na fatura: texto exibido na fatura, acima do botão de visualizar o Pix.
  • Enviar estatísticas de uso (opcional): controla o envio identificado das estatísticas de confirmação de pagamento. Desmarcado, as confirmações continuam sendo contabilizadas de forma anônima.

Informações importantes

  • A tarifa do Pix é paga separadamente à Efí, conforme o plano da sua conta.
  • O certificado precisa estar em formato PEM e acessível pelo PHP no servidor. Mantenha o arquivo fora da raiz pública do site.
  • Sempre faça backup antes de mudar algo no seu sistema.

Suporte

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

Licença

Contrato de licença de uso

Changelog

v1.4.0: Pix no email com página do Pix com a sua marca - 13/10/2026

Melhorias:

  • Versão 1.4.0: Pix no email com página do Pix com a sua marca e painel no admin - #22 enhancement
  • Estatísticas de uso com padrão desmarcado - #21
  • Atualização importante de segurança - #20
  • Webhook Pix não registrado na Efí e módulo não re-registra - #17

v1.3.3: Atualização importante de segurança - 12/10/2026

Melhorias:

  • Atualização importante de segurança - #20
  • Warnings PHP no link da fatura (redirecttobillet e outros) - #19
  • Confirmação ao reabrir fatura falha e txid pago é sobrescrito ao regenerar cobrança - #18
  • Webhook Pix não registrado na Efí e módulo não re-registra - #17

v1.3.1 - 22/08/2026

Melhorias:

  • Webhook Pix não dá baixa automática (handler espera $_POST['id'] em vez do JSON da Efí) - #16
  • readme: link de suporte para o forum do proprio modulo - #14
  • readme: contador do site, captura sem aviso de hook e secao de licenca - #13
  • readme: captura versionada, badges e sumario - #12
  • readme: conteudo da pagina do site transferido e captura de configuracao - #11

v1.3.0 - 12/07/2026

Melhorias:

  • Telemetria com consentimento (v1.3.0) - #10
  • Adicionar consentimento e padronizar telemetria - #9
  • Migrar repo para org gofas - #8
  • Sincronizar pagamentos diretos Efí com WHMCS (criar clientes se necessário) - #7 enhancement

v1.2.0 - 07/06/2026

Melhorias:

  • Compatibilidade com PHP 8.2 e 8.3 - #5

v1.1.1 - 02/12/2024

Melhorias:

  • Melhorada a logica de formação dos URLs para impedir barras duplicadas - #4

v1.1.0 - 16/09/2024

Melhorias:

  • Cobranças agora são geradas com CPF e CNPJ dando prioridade para CNPJ - #3 enhancement

v1.0.1 - 11/04/2024

Melhorias:

  • Lançamento 🎉 - #1 enhancement

Correções:

  • Reduz a descrição para no máximo 140 caracteres - #2 bug

v1.0.0 - 28/02/2024

Melhorias:

  • Lançamento 🎉 - #1 enhancement

Deixe um Comentário

Você precisa fazer login para publicar um comentário.

Role para cima