Pagamentos em cripto para WHMCS
Receba cripto nas faturas do WHMCS. O cliente clica em Pay Now, paga na página da SnapEX Pay em USDT nas redes TRON, Ethereum, BSC e outras, ou em outras moedas convertidas para USDT, e a fatura é marcada como paga no WHMCS automaticamente.
Grátis. Versão 1.1.0.
O que faz
- Sem carteiras nem nodes para manter: o dinheiro entra no seu saldo de comerciante na SnapEX Pay.
- Três formas independentes de marcar uma fatura como paga: o webhook assinado, o retorno do cliente da página de pagamento e uma verificação em segundo plano nas execuções do cron do WHMCS (cada pagamento pendente no máximo a cada 10 minutos, durante 5 dias). Um webhook perdido nunca deixa uma fatura paga em aberto, e um pagamento nunca é lançado duas vezes.
- WHMCS com várias moedas: com Convert To For Processing em USD, as faturas continuam registradas na moeda do cliente.
- Pagamentos parciais nunca são aplicados automaticamente: vão para o Gateway Log para você revisar. Com o webhook configurado, o dinheiro que chega depois que a fatura da SnapEX Pay foi encerrada também é registrado lá.
- Modo de teste: faturas de teste se confirmam sozinhas, sem dinheiro real; enquanto ele está ativo, só administradores logados veem o botão de pagamento, e os demais clientes veem um aviso de “modo de teste”.
Instalação
- Envie o conteúdo do arquivo compactado para a pasta raiz do WHMCS, mantendo os caminhos:
modules/gateways/snapexpay.php,modules/gateways/snapexpay/,modules/gateways/callback/snapexpay.php,includes/hooks/snapexpay.php. - No painel administrativo do WHMCS, abra System Settings → Payment Gateways → All Payment Gateways e ative SnapEX Pay (Crypto).
- No painel do comerciante da SnapEX Pay, crie uma chave de API com os escopos
invoices.readeinvoices.writee cole-a no campo API key. - Webhook (recomendado): no painel, defina a URL do webhook como
https://<your WHMCS>/modules/gateways/callback/snapexpay.php(o endereço exato aparece abaixo do campo no WHMCS) e cole a chave secretawhsec_…em Webhook secret. - Se a moeda do seu WHMCS não for USD, defina Convert To For Processing como USD. As faturas continuam registradas na moeda do cliente.
- Ative o Test mode, abra uma fatura não paga como administrador, pague-a na página da SnapEX Pay com um método de teste e confira se ela muda para Paid. Depois, desative o modo de teste.
Configurações
| API key | Do painel da SnapEX Pay. |
|---|---|
| Webhook secret | A chave whsec_… das configurações de webhook do painel. Sem ela, o módulo continua funcionando pela página de retorno e pelo cron. |
| Network fee paid by | Merchant: o cliente paga exatamente o valor da fatura, e a taxa é descontada do que você recebe. Client: a taxa da SnapEX Pay e a taxa de rede são somadas ao valor. |
| Payment window, minutes | Por quanto tempo a página de pagamento fica válida (1–1440, padrão 60). Clicar em Pay Now de novo mais tarde abre uma página nova. |
| Test mode | Faturas de teste; enquanto ele está ativo, só administradores veem o botão de pagamento. Pagamentos de teste são ignorados depois que o modo de teste é desativado. |
| Partner ID | Opcional: o Partner ID do integrador que configurou o módulo (programa de indicações da SnapEX Pay). Deixe em branco se você mesmo fez a configuração. |
| API URL | Deixe como está. |
Perguntas
O que acontece se o webhook não chegar?
A fatura é marcada como paga mesmo assim: o módulo também verifica o pagamento quando o cliente volta da página de pagamento e nas execuções do cron do WHMCS (cada pagamento pendente no máximo a cada 10 minutos, durante 5 dias). Um pagamento nunca é lançado duas vezes.
A moeda do meu WHMCS não é USD. Vai funcionar?
Sim. Defina Convert To For Processing como USD nas configurações do gateway; as faturas continuam registradas na moeda do cliente.
E se o cliente enviar menos que o valor da fatura?
Se o cliente não completar o pagamento a tempo, nada é lançado automaticamente. O Gateway Log recebe um registro “Partial payment — review and apply manually” com o valor recebido.
E se o dinheiro chegar depois que a fatura da SnapEX Pay foi encerrada?
Ele não é aplicado automaticamente no WHMCS. Com o webhook configurado, o Gateway Log recebe um registro; o dinheiro fica no seu saldo da SnapEX Pay.
Posso testar sem dinheiro real?
Sim. Ative o Test mode: as faturas de teste se confirmam sozinhas; enquanto ele está ativo, só administradores logados veem o botão de pagamento.
Onde vejo o que o módulo fez?
No WHMCS, em Billing → Gateway Log. O ID da transação de um pagamento é o ID da fatura da SnapEX Pay (INV-…).
Outras integrações
Pronto para receber em cripto?
Crie uma conta de comerciante, gere uma chave de API e conecte o módulo. 1% por pagamento, sem mensalidade.