Plugins de e-commerce
WHMCS Gateway
Instale e configure o gateway WHMCS oficial com OAuth nativo, checkout hospedado MakePay e retornos de chamada assinados.
Gateway MakePay para WHMCS
Resumo
O gateway MakePay oficial para WHMCS adiciona criptografia hospedada checkout às faturas WHMCS. WHMCS renderiza um botão de pagamento na fatura, MakePay cria o link de pagamento hospedado e o retorno de chamada assinado marca a fatura como paga após a compensação do pagamento.
Use Conecte MakePay para configuração normal. Credenciais manuais com chave API ainda estão disponíveis como alternativa.
Antes de começar
- WHMCS 8.13 LTS ou WHMCS 9.x
- PHP 8.1 ou superior com OpenSSL habilitado
- Sistema WHMCS URL sobre HTTPS
- Acesso de administrador WHMCS a gateways de pagamento
- Uma empresa MakePay onde você pode gerenciar ajustes de pagamento
Instale o gateway
Baixe o pacote ZIP mais recente:
https://plugins.makecrypto.io/downloads/whmcs/latest.zip
Extraia o ZIP e carregue o diretório modules na raiz do WHMCS. O pacote instala estes arquivos:
modules/gateways/makepay.php
modules/gateways/makepay/checkout.php
modules/gateways/makepay/oauth.php
modules/gateways/makepay/lib/*.php
modules/gateways/callback/makepay.php
No WHMCS, abra Configurações do sistema > Gateways de pagamento, habilite MakePay e salve as configurações do gateway.
Conecte MakePay
Abra as configurações do gateway MakePay e escolha Conectar MakePay. A porta de entrada:
- Abra MakeCrypto em uma guia do navegador.
- Ele pede que você faça login e escolha a empresa que receberá os pagamentos.
- Mostra as permissões exigidas pelo gateway WHMCS.
- Retorna você ao WHMCS após passar.
- Salve a conexão nas configurações do gateway WHMCS.
- Configura o retorno de chamada MakePay URL e o segredo webhook.
Configurar MakePay
Após a conexão, ele mantém o método Connection no modo conectado padrão. Verificar:
- ID da empresa MakePay
- Ativo de liquidação
- Expiração do pagamento
- Status da conexão MakePay
- Segredo de assinatura webhook
O fallback manual requer o ID da empresa MakePay, o ID da chave API, o segredo da chave API e o segredo webhook.
Fluxo checkout
Quando um cliente abre uma fatura WHMCS não paga, o gateway MakePay exibe um botão de pagamento. O manipulador checkout valida a carga útil do formulário assinado, carrega a fatura usando auxiliares WHMCS API locais, cria um link de pagamento MakePay e redireciona o cliente para o checkout MakePay hospedado.
| Campo | Propósito |
|---|---|
source=whmcs | Identifique a integração |
orderId=whmcs_invoice_<invoiceId> | Mapeia a atividade MakePay de volta para WHMCS |
invoiceId | ID da fatura WHMCS |
clientId | ID do cliente WHMCS |
moduleVersion | Versão instalada do gateway MakePay |
whmcsVersion | Versão de tempo de execução WHMCS |
O comprador reverte para a fatura WHMCS original após o pagamento ou cancelamento.
Status da fatura
MakePay envia retornos de chamada assinados para:
https://billing.example.com/modules/gateways/callback/makepay.php
| Estado MakePay | Comportamento WHMCS |
|---|---|
paid, completed, confirmed, succeeded | Ligue para addInvoicePayment e registre o ID da transação |
failed, expired | Registre o retorno de chamada e deixe a fatura não paga |
cancelled, canceled | Registre o retorno de chamada e deixe a fatura não paga |
refunded | Registre o retorno de chamada para revisão manual |
| Outros estados | Eles são registrados e ignorados |
Os logs de transações WHMCS incluem a carga útil de retorno de chamada MakePay para que as equipes de suporte possam rastrear o pagamento UID, metadados da fatura, valor e status.
Notas de segurança
O gateway salva os detalhes da conexão nas configurações do gateway WHMCS. Limite o acesso do administrador WHMCS a operadores confiáveis e desconecte o gateway em MakeCrypto se uma conta de administrador ou backup de servidor for exposta.
A conexão solicita estas permissões:
company:readmakepay:payment-links:readmakepay:payment-links:writemakepay:customers:readmakepay:customers:writemakepay:settings:readmakepay:settings:write
Solução de problemas
Se Connect MakePay falhar ao iniciar, confirme se o sistema WHMCS URL é HTTPS e corresponde ao domínio de cobrança público. Se os clientes virem um erro checkout, confirme se o gateway está ativo, se a fatura não foi paga e se o ID da empresa MakePay foi salvo. Se os retornos de chamada não marcarem as faturas como pagas, compare o URL do retorno de chamada MakePay com o URL do retorno de chamada WHMCS anterior e gire o segredo de webhook nas configurações do gateway.