MÓDULO PADMONEY BOLETO PARA WHMCS

O módulo de integração Gofas Padmoney para WHMCS é gratuito, e oferece o todas as funcionalidades dos nossos melhores e mais recentes módulos. Gera boletos registrados personalizados com a marca da sua empresa, diretamente nas faturas e ainda envia os dados do boleto, nos emails de faturas do WHMCS.

Padmoney oferece um painel de controle simples e prático, cobra apenas quando um boleto é pago e suas tarifas são baixas. Para usuários do nosso módulo ou clientes que se cadastrarem por este link, a tarifa é fixa de R$ 2,40 por boleto liquidado, sem mensalidades, sem taxas de emissão, cancelamento ou manutenção + 1 transferência gratuita por semana 😉

CAPTURAS DE TELA

FUNCIONALIDADES

Cobranças com seu CPF ou CNPJ, sem carteira de cobrança e sem burocracia

✓ Juros e multas após o vencimento do boleto

✓ 2ª via automática com valor atualizado (cálculo de multa e juros) ao acessar a fatura

✓ Boleto com suas cores e logotipo

✓ Linha digitável e informações do boleto no corpo dos emails do WHMCS

✓ Link direto para o boleto no email

✓ Redireciona para o boleto ao acessar a fatura

✓ Detecção automática de campos personalizados (CPF/CNPJ)

✓ Notifica administradores do WHMCS sobre erros ao gerar boletos

✓ Exibe a linha digitável do boleto na fatura, com opção de copiar apenas com um clique

✓ Imagem personalizada para o botão "Finalizar Pagamento"

✓ Desconto por método de pagamento

✓ Desconto para pagamento antes do vencimento com opção de dias para contar

✓ Descontos personalizados em R$ e % no perfil de clientes específicos via custom fields

✓ Permite adicionar tarifa adicional / boleto*

✓ Exibe(ou não) na fatura informações de desconto, taxas e demais cálculos

✓ Confirmação de pagamento baixa nas faturas pagas automaticamente, ao rodar o cron diário e ao acessar a fatura

Aviso de atualização e verificação de versão diretamente nas configurações do módulo

+ E muito mais, confira as configurações

INSTALAÇÃO

Para usufruir de todos os recursos da integração, você deverá instalar 2 módulos distintos que trabalham em conjunto, o módulo Gateway Gofas Padmoney Boleto + o Módulo Addon Gofas Padmoney.

Ao descompactar o arquivo do download, observe que os diretórios foram distribuídos seguindo a mesma hierarquia dos diretórios padrão do WHMCS, o arquivo + pasta do módulo Gateway está localizado no diretório /modules/gateways/ e a pasta do módulo Addon está localizada no diretório /modules/addons/. Siga os passos a seguir se precisar de mais detalhes:

  1. Faça download do módulo;
  2. Descompacte o arquivo .zip;
  3. Instalação do Addon: Copie o diretório gofaspadmoney localizado na pasta /modules/addons/ do arquivo recém descompactado, para a pasta /modules/addons/ da instalação do WHMCS;
  4. Instalação do Gateway: Copie o arquivo gofaspadmoneyboleto.php + o diretório /gofaspadmoneyboleto/, localizados na pasta /modules/gateways/ do arquivo recém descompactado, para a pasta /modules/gateways/ da instalação do WHMCS;

PRÉ CONFIGURAÇÃO

  1. Crie um campo personalizado de cliente para CPF e/ou CNPJ, ou se preferir, crie dois campos distintos, um campo apenas para CPF e outro campo para CNPJ. O módulo identifica os campos do perfil do cliente automaticamente;

  2. Opcional: Crie dois campos personalizados se desejar oferecer descontos personalizados para clientes específicos, semelhantes aos campos nesta imagem.

  3. Ative o Addon em Opções > Módulos Addons > Localize o módulo "Gofas Padmoney" > Clique em Ativar > Após ativar, clique em "Configurar" > assinale os grupos de administradores ou operadores que terão permissão para acessar o módulo > clique em "Salvar alterações".;

  4. Ative o Gateway em Opções > Pagamentos > Portais de Pagamento > Aba "All Payment Gateways" > Clique em "Gofas Padmoney - Boleto";

  5. Defina o nome de exibição do método de pagamento, exemplo: "Boleto Bancário". Após esses passos básicos, sigas as instruções a seguir atentamente para entender como funciona cada configuração do módulo.

 

CONFIGURAÇÕES DO MÓDULO

  1. Chave de Segurança - Produção: (Obrigatório) . Para criar, acesse sua conta Padmoney, clique na foto de perfil no topo à direita da página > Configurações > Integração com API. Digite uma senha no campo "Chave de Segurança" e clique em "Gerar novo Token". Copie e salve o Token gerado;

  2. Token - Produção: (Obrigatório) Token gerado no passo anterior;

  3. Chave de Segurança - Desenvolvimento: (Obrigatório) Cadastre uma conta de testes em dev.padmoney.com e crie uma chave de segurança como descrito no passo 01;

  4. Token - Desenvolvimento: (Obrigatório) Token gerado no passo anterior;

  5. Modo de Testes / Sandbox:  Ative essa opção para gerar cobranças em modo de testes. Recomendamos fortemente que sejam realizados testes em modo sandbox simulando cada possível situação configurada no módulo, antes de gerar cobranças reais em produção.

  6. Modo Diagnóstico / Debug: (não use em produção) Mostra informações de diagnóstico na tela de exibição das Faturas. Essas informações servem para verificar todas as informações "cruas" processadas pelo módulo na página de visualização das faturas;

  7. Salvar Logs:  Salva informações de diagnóstico em Utilitários > Logs > Log de Módulo. Para funcionar, antes é necessário ativar o debug de módulo clicando em "Ativar Log de Debug"  na página "Log de Módulo" do painel administrativo do WHMCS;

  8. Valor da tarifa por Boleto: Insira o valor da comissão paga à Padmoney a cada Boleto com pagamento confirmado. Essa informação servirá para calcular e preencher o campo "Taxas" (fee) da lista de transações do WHMCS. Use ponto(.) para separar casas decimais, ex.: 1.5
  9. Valor mínimo do Boleto: Insira o valor mínimo da fatura para permitir pagamento via Boleto, 5 equivale à R$ 5,00. O valor mínimo padrão é R$5,00.

  10. Informações do Boleto no email: Adiciona link, linha digitável, vencimento e outras informações do boleto no corpo dos emails de faturas. Essa opção faz o módulo gerar os boletos no momento em que a fatura é gerada, (do contrário o Boleto é gerado no 1º acesso à Fatura). Veja aqui a lista de tags de mesclagem dosponíveis .

  11. Substituir link da fatura por link do boleto: Substitui o URL da Fatura pelo URL do Boleto nos emails de Faturas do WHMCS, através da tag padrão {$invoice_link} do template de email.

  12.  Cancelar Boleto ao cancelar Fatura: Cancela o Boleto associado à uma fatura quando essa fatura é cancelada nas lista de faturas do WHMCS.
  13. Verificar pagamentos ao rodar o cron: Verifica os Boletos pagos e da baixa nas faturas ao rodar o cron diário. Garante as confirmações de pagamento mesmo no caso de falhas ou atrasos na entrega das notificações da API (callback).
  14. Cancelar Boleto Vencido: Cancela o Boleto gerado anteriormente pela Fatura antes de gerar novo Boleto (segunda via). Sem essa opção definida, o módulo gera um novo boleto sem cancelar ou alterar o Boleto anterior.
  15. Dias adicionais para novo vencimento: Número de dias que serão somados a data do vencimento do Boleto ao gerar segunda via ou atualizar um boleto vencido. Essa opção aplica-se apenas a Faturas vencidas, faturas que ainda não venceram sempre irão gerar Boletos com a mesma data de vencimento da Fatura.
  16. Notificar admins do WHMCS sobre erros: Escolha o departamento de suporte que receberá notificação por email quando houver erros ao gerar o boleto. Esse recurso possibilita uma tomada de ação antes que o cliente contacte o suporte ou desista da compra, como por exemplo, quando o boleto não é gerado por um erro de cadastro do cliente.
  17. Tipo de Desconto Personalizado: Selecione o Campo Personalizado de Clientes que define o tipo de desconto personalizado em R$(Reais) e %(Porcentagem). Veja aqui como configurar os Campos Personalizados de Clientes.

  18.  Valor do Desconto Personalizado: Escolha o Campo Personalizado de Clientes usado para aplicar descontos diferenciados para clientes específicos. Formato: Decimal, separado por ponto. Maior ou igual a 0.00 e menor que o valor da cobrança.

  19. Desconto ou Taxa adicional: Escolha de deseja oferecer desconto ou acrescentar taxa para pagamentos via Boleto.

  20. Tipo de desconto/taxa: Escolha se o desconto ou taxa será em Porcentagem ou em Reais

  21. Valor do Desconto ou Taxa: Valor que será abatido ou acrescentado ao valor total das faturas.

  22. Validade do Desconto: Defina o máximo de dias antes do vencimento para aplicar desconto.
    - Deixe em branco para aplicar desconto mesmo após o vencimento;
    - Insira 0 (zero) para aplicar desconto a Boletos gerados até a data de vencimento da Fatura;
    - Insira de 1 a X, sendo X = ao nº de dias antes do vencimento, que as Faturas são geradas para aplicar desconto apenas a Boletos gerados entre 1 e X dias antes da data de vencimento da Fatura.
    Ao ativar essa opção a data de vencimento do Boleto será igual a data de vencimento da Fatura - (menos) o nº de dias definido nesse campo. Será adicionada a instrução ao caixa "não aceitar pagamento após o vencimento".

  23. Multa após o vencimento: Multa cobrada após o vencimento, máximo 10.00 (%). Use ponto(.) para separar casas decimais, ex.: 1.5.

  24. Juros após o vencimento: Juros por dia (mínimo 0.01 e máximo de 0.33). Use ponto(.) para separar casas decimais.

  25. Exibir linha digitável na Fatura: Exibe a linha digitável/código de barras do Boleto, abaixo do botão "visualizar boleto".

  26. Exibir data de Vencimento:  Exibe a data de vencimento do Boleto na fatura, abaixo do botão "visualizar boleto";

  27. Exibir Desconto / Taxa na fatura: Assinale se desejar informar sobre o Desconto ou Taxa na fatura.
  28. Redirecionar para o Boleto: Redireciona o cliente diretamente para o URL do boleto ao acessar a fatura. Adicione &redirectToBillet=false ao URL da fatura para desativar em acessos específicos, assim como você pode adicionar &redirectToBillet=true para redirecionar para o boleto mesmo se essa opção não estiver ativada. Exemplo: https://whmcs.gofas.net/viewinvoice.php?id=4800&redirectToBillet=false. Nos templates de email a mergetag ficaria desta forma: {$invoice_link}&redirectToBillet=false.

  29. Imagem do botão "Visualizar Boleto": Insira o URL da imagem que será usada como botão "Visualizar Boleto" (tamanho recomendado: 160x43px).

Em versões do WHMCS menores que 7.2.3 será exibido o campo "Admin do WHMCS", onde deverá ser configurado o ID ou username do admin com permissões de uso da API interna do WHMCS.

TAGS DE MESCLAGEM

Utilize as mergetags geradas pelo módulo addon para exibir informações do Boleto nos emails de Faturas do WHMCS.

Para adicionar as tags edite os templates de email referentes à faturas em WHMCS admin > Opções > Modelos de Email.

As tags de mesclagem permitem adicionar um bloco html ao email com as principais informações do boleto, ou cada informação separadamente, para auxiliar na formatação do texto dos emails.

Tags disponíveis

{$gpmb_billet_info}: Exibe um bloco com as principais informações sobre o boleto;

{$gpmb_link}: Exibe o URL do boleto;

{$gpmb_barcode}: Exibe a linha digitável do Boleto (nº que forma o código de barras);

{$gpmb_expire_at}: Exibe a data de vencimento do Boleto;

{$gpmb_total}: Exibe o valor total do Boleto;

{$gpmb_charge_id}: Exibe o código do Boleto(ID registrado na API Juno);

{$gpmb_api_mode}: Exibe se o boleto foi gerado na API em modo live ou sandbox

{$gpmb_log}: Exibe informações de diagnóstico no corpo dos emails (não use em produção)

DOWNLOAD GRATUITO

Ao baixar esse módulo você concorda com nosso contrato de licenciamento de software.

ATUALIZAÇÕES

  • v1.0.0
    • Lançamento.

Atualizações por email

Digite seu endereço de email para ser notificado sempre que o módulo for atualizado.