Integra o checkout transparente do PayPal diretamente na fatura do WHMCS, sem redirecionar o cliente para fora do seu site. Desenvolvido pela Gofas Software.
- Por que usar
- Funcionalidades
- Requisitos
- Instalação
- Configuração
- Informações importantes
- Perguntas frequentes
- Changelog
- Suporte
- Licença
- Checkout sem sair do site. O formulário do PayPal aparece embutido na fatura do WHMCS, sem redirecionamento
- Cartão ou saldo PayPal. O cliente paga como preferir, inclusive com cartões salvos na conta PayPal
- Baixa automática. A notificação do PayPal confirma o pagamento e quita a fatura sozinha
- CPF e CNPJ do cliente. Os campos personalizados do WHMCS alimentam o checkout, como o PayPal exige no Brasil
- Testes sem risco. O ambiente sandbox do PayPal valida todo o fluxo antes de ir para produção
- Checkout transparente do PayPal embutido na fatura, sem redirecionamento externo
- Cartões salvos pelo cliente no PayPal
- Confirmação automática de pagamento via notificação (callback) do PayPal
- Imagem personalizada para o botão "Finalizar Pagamento"
- Ordem dos campos CPF e CNPJ configurável
- Suporte a produção e a testes (sandbox)
- Modo diagnóstico e log de callbacks
- Aviso de atualização e verificação de versão na própria tela de configuração do módulo
- WHMCS 8.x ou superior
- PHP 8.1 a 8.4, com cURL e ionCube Loader (14 para PHP 8.1, 15 ou superior para PHP 8.2+)
- Cron do WHMCS ativo, para a revalidação da licença
- Conta PayPal com aplicativo REST API criado (Client ID e Client Secret, produção e sandbox)
- Baixe o arquivo em https://gofas.net/gppd/ e descompacte. Será criada a pasta
gofaspaypalplus. - Copie a pasta
modulesde dentro degofaspaypalpluspara a raiz da instalação do WHMCS, mesclando com as pastas existentes. - Ative o módulo em
Opções > Pagamentos > Portais para Pagamentos > aba All Payment Gateways, clicando em "Gofas PayPal Plus". - Informe a chave de licença, o Client ID e o Client Secret.
Crie um aplicativo REST API no painel de desenvolvedor do PayPal (https://developer.paypal.com/developer/applications/) e copie o Client ID e o Client Secret de produção e de sandbox.
- Chave de licença: obtida ao adquirir o módulo. Sem licença ativa o módulo não cria novos pagamentos no PayPal.
- Live Client ID e Live Client Secret: credenciais de produção do aplicativo.
- Sandbox Client ID e Sandbox Client Secret: credenciais do ambiente de testes.
- Sandbox: alterna entre o ambiente de testes e produção.
- Debug: exibe resultados e erros retornados pela API. Não use em produção.
- Log callback: grava as notificações recebidas do PayPal.
- Administrador atribuído: administrador com permissão para usar a API interna do WHMCS.
- Ordem do campo CPF ou CNPJ e Ordem do campo CNPJ: posição dos campos personalizados de cliente usados pelo módulo.
- Imagem do botão Finalizar Pagamento: URL da imagem usada no botão de pagamento.
- 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.
- As tarifas do PayPal são pagas separadamente, conforme o plano da sua conta.
- Sem licença ativa, os pagamentos já criados continuam sendo confirmados. O módulo apenas deixa de criar novos pagamentos até a licença ser regularizada.
- Sempre faça backup antes de mudar algo no seu sistema.
A baixa da fatura é automática?
Sim. O PayPal envia a notificação de pagamento para o WHMCS e o módulo quita a fatura correspondente.
Posso testar antes de cobrar de verdade?
Sim. Com o Sandbox ligado e as credenciais de testes, todo o fluxo roda no ambiente de testes do PayPal, sem gerar cobrança real.
O que acontece se a licença ficar inativa?
Os pagamentos já criados continuam sendo confirmados. O módulo apenas deixa de criar novos pagamentos até a licença ser regularizada.
Veja changelog.md.
Abrir issue no fórum do módulo.
Melhorias:
- Converter para módulo pago (verificação de licença + ionCube + produto WHMCS) - #9
- 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
Melhorias:
- Telemetria com consentimento (v2.2.0) - #3

