Instale e configure o Pix da Efí Pay no seu WHMCS

Você também vai precisar de

• Uma conta Efí Pay com acesso à API Pix.
• A chave de licença do módulo, disponível na sua área de cliente da Modules Pay.
• O WHMCS acessível publicamente por HTTPS, para que a Efí consiga enviar as notificações de pagamento.
• O OpenSSL instalado no seu computador, para converter o certificado.

1. Baixe o módulo na área de cliente da Modules Pay (é necessário fazer login) e descompacte o arquivo .zip.
2. Copie o arquivo efipixmpay.php e a pasta efipixmpay/, que estão em modules/gateways/, para modules/gateways/ da sua instalação do WHMCS.
3. Copie o arquivo efipixmpay.php de includes/hooks/ para includes/hooks/ da sua instalação do WHMCS.
4. Crie a pasta modules/gateways/efipixmpay/certs/ caso ela ainda não exista. É nela que ficará o certificado.

includes/
└── hooks/
    └── efipixmpay.php              # hooks (codificado com ionCube)
modules/
└── gateways/
    ├── efipixmpay.php              # gateway
    └── efipixmpay/
        ├── certs/                  # certificado .pem (etapa 6)
        ├── images/
        ├── webhook/
        │   └── index.php           # recebe as notificações da Efí
        ├── config.php
        ├── functions.php
        ├── validarpagamento.php
        └── whmcs.json

1. Na conta Efí, abra API no menu inferior esquerdo e depois Aplicações.
2. Crie uma nova aplicação ou selecione uma existente. Garanta que a API Pix esteja habilitada nela, com os escopos de cobrança com vencimento e de webhook.
3. Copie a Chave Client ID e a Chave Client Secret do ambiente de Produção. Guarde-as para a etapa 9.

Documentação oficial: dev.efipay.com.br – Credenciais.

Gerar o certificado .p12

1. Acesse o item API no menu inferior esquerdo da conta Efí.
2. No menu à esquerda, clique em Meus Certificados.
3. Selecione o ambiente Produção.
4. Clique em Novo Certificado (botão azul).
5. Dê uma descrição para identificar o certificado no futuro, por exemplo WHMCS Pix.
6. Confirme a criação, baixe o arquivo e clique em prosseguir.

Converter para .pem

Execute no terminal, na pasta onde está o arquivo baixado. O comando junta o certificado e a chave em um único arquivo, sem senha:

openssl pkcs12 -in certificado.p12 -out certificado.pem -nodes -password pass:""

Troque certificado.p12 pelo nome do arquivo baixado. O nome do .pem pode ser qualquer um: ele será escolhido em uma lista nas configurações.

1. Acesse Pix → Minhas Chaves.
2. Cadastre uma chave aleatória.
3. Copie a chave cadastrada para usar na etapa 9.

Envie o arquivo .pem para:

modules/gateways/efipixmpay/certs/

Require all denied

Mantenha somente certificados nesta pasta: todos os arquivos dela aparecem na lista de seleção.

1. Se ainda não existir, crie um único campo para CPF e CNPJ no perfil do cliente, por exemplo CPF/CNPJ.
2. Recomendado: marque o campo como obrigatório e exiba-o no formulário de cadastro, para que todo cliente o preencha.

1. No painel administrativo, acesse Apps & Integrations.
2. Pesquise por “Efí Pay Pix”.
3. Clique em Activate.

Também é possível ativar em Configurações → Pagamentos → Gateways de Pagamento → Todos os Gateways, escolhendo EFI PAY PIX - Modules Pay.

Credenciais e identificação

Valores, taxas e encargos

Clique em Salvar Alterações. Nesse momento o módulo verifica a licença, a versão do PHP e cria a tabela mod_efimpay, se necessário.

Quando uma fatura com Pix é aberta pela primeira vez, o módulo registra na Efí, para a sua chave Pix, a URL:

https://SEU-WHMCS/modules/gateways/efipixmpay/webhook/?hmac=<seu-dominio>&ignorar=

É por ela que a Efí avisa o pagamento e a fatura é baixada automaticamente.

• A URL precisa responder por HTTPS com certificado SSL válido.
• Firewall, WAF ou Cloudflare não podem bloquear requisições da Efí para essa URL.
• Se o endereço do WHMCS mudar, abra e salve as configurações do gateway e depois abra uma fatura para que o webhook seja recadastrado.

1. Crie ou use um cliente de teste com CPF/CNPJ válido e endereço preenchido.
2. Gere uma fatura de valor baixo (por exemplo, R$ 1,00) com a forma de pagamento EFI PAY PIX.
3. Abra a fatura na área do cliente. Devem aparecer o QR Code e o Pix Copia e Cola.
4. Pague com o app do seu banco e mantenha a fatura aberta: a página recarrega como Paga em poucos segundos.
5. No admin, confira a transação na fatura e as mensagens [EFI PIX MPAY] em Utilitários → Logs → Log de Atividades.

• PHP, ionCube e versão do WHMCS compatíveis
• Arquivos em modules/gateways/ e includes/hooks/
• Client ID e Client Secret de produção copiados
• Certificado convertido para .pem e enviado para certs/
• Pasta certs/ protegida contra acesso pela web
• Chave Pix aleatória cadastrada
• Campo personalizado CPF/CNPJ criado e selecionado
• Licença ativa no painel do gateway
• Pagamento de teste baixado automaticamente