Módulo Boleto Fácil | Juno para WHMCS v4 · 2020-04-29 · ( valor adicional somado a taxa de...

1

Moacutedulo Boleto Faacutecil | Juno para WHMCS ndash v46

2

IacuteNDICE

SOBRE 2

PRINCIPAIS FUNCIONALIDADES 2

REQUISITOS 2

INSTALACcedilAtildeO 2

CONFIGURACcedilAtildeO INICIAL 3

CONFIGURACcedilOtildeES DIVERSAS 4

RETORNO AUTOMAacuteTICO 16

SUPORTEDUacuteVIDAS 22

PERGUNTASRESPOSTAS 16

WIDGET SALDO 24

SANDBOX 25

SOBRE

Moacutedulo desenvolvido utilizando a API oficial httpsbitlyAPIBoletoBancarioCom

da BoletoBancariocom que permite emissatildeobaixa automaacutetica de pagamentos

por boleto bancaacuterio via WHMCS

PRINCIPAIS FUNCIONALIDADES

- Faacutecil integraccedilatildeo dispensando usuaacuteriosenha ou email de acesso

- Dispensa configuraccedilatildeo Retorno Automaacutetico (Notificaccedilatildeo de Pagamentos)

- Geraccedilatildeo uacutenica da transaccedilatildeorequisiccedilatildeo ateacute o vencimentoexpiraccedilatildeo do boleto

- Limitar a utilizaccedilatildeo do moacutedulo por valor fixo

- Prazo Pagamento do boleto multajuros apoacutes vencimento (caacutelculo automaacutetico)

- Desconto (Fixo ou Percentual) para pagamentos antecipados

- Inclusatildeo de Taxas ( percentual + auxiliartaxa fixa )

- Possibilidade de isenccedilatildeo de taxas apartir de X reais

- Personalizar botatildeo de pagamento

- Ajuste automaacutetico do vencimento do boleto

- Prazo boleto

- EXCLUSIVO (Linha digitaacutevel + Link Direto do Boleto) na fatura ou emails

- Redirecionamento Automaacutetico para o boleto

- Retorno Automaacutetico

- Detecta Fraude

- SandBox (conta para testes) - Log completo do Retorno Automaacutetico

- E etc

REQUISITOS

- Qualquer versatildeocharset do WHMCS

- Conta BoletoBancariocom

INSTALACcedilAtildeO

Efetue a compra do moacutedulo httpjunoedvancombr

Apoacutes confirmado pedidopagamento vocecirc receberaacute o e-mail com as instruccedilotildees de

instalaccedilatildeoconfiguraccedilatildeo

Descompacte o arquivo boletofacilzip e envie as pastasarquivos para raiz do

seu WHMCS Lembre-se de cadastrar a licenccedila fornecida pela Edvancombr no

arquivo configurationphp que fica na pasta raiz do seu WHMCS

Em seguida acesse httpseuwhmcsadminconfiggatewaysphp ou clique em

Setup | Payments | Payment Gateways

3

- WHMCS v5x

Em Activate Module localize o moacutedulo BoletoBancariocom e clique em

Activate

- WHMCS v6x ou v7x

Clique na aba All Payment Gateways e clique em BoletoBancariocom

Moacutedulo instalado

CONFIGURACcedilAtildeO INICIAL

1) Acesse httpsappjunocombr insira seu e-mailsenha

2) Acesse o link httpsappjunocombrintegration

Localize a opccedilatildeo Token Privado clique em Gerar Token privado

Copie o Token e insira no campo Token do moacutedulo Boleto FaacutecilJuno

Natildeo seraacute necessaacuterio configurar URL de Retorno Automaacutetico (Notificaccedilatildeo

Pagamentos)

Pronto agora vocecirc poderaacute receber pagamentos via Juno

4

CONFIGURACcedilOtildeES DIVERSAS

- Limites (MaacuteximoMiacutenimo) estabelece um limite maacuteximo e miacutenimo em Reais para recusar pagamento

Exemplo foi configurado um limite maacuteximo R$ 5000

Ao tentar pagar uma fatura com valor maior ou igual a R$ 5000 o sistema natildeo iraacute

permitir

======================================================================================

- MultaJuros Para que seja possiacutevel habilitar a cobranccedila de MultaJuros sobre o boleto vencido

Informe no campo ldquoPrazo Pagamentordquo (4) a quantidade maacutexima de dias que o

boleto poderaacute ser pago apoacutes o vencimento (limite maacuteximo 29 dias) Caso o campo

esteja em branco ou com valor ldquo0rdquo natildeo haveraacute cobranccedila de multajuros

Evite alterar constantemente o valor desse campo pois influenciaraacute nas faturas

geradas anteriormente

Informe a ldquoMulta ao Mecircsrdquo (6) exemplo 2=2 (maacuteximo permitido por lei vocecirc

poderaacute configurar outro valor por sua conta em risco)

No campo ldquoJuros Morardquo (7) exemplo 1=1 (maacuteximo permitido por lei caso

informe um valor gt 1 o sistema natildeo permitiraacute a emissatildeo do boleto)

O caacutelculo da multajuros e vencimento eacute efetuado diretamente pelo canal de

pagamento (correspondente bancaacuterio loteacuterica internet banking e etc)

Outras informaccedilotildees sobre esse caacutelculo clique aqui

5

Caso a opccedilatildeo Isentar MultaJuros (5) esteja habilitada e o perfilprofile do

cliente esteja indicando a natildeo aplicaccedilatildeo de taxas o moacutedulo natildeo permitiraacute cobranccedila

de multajuros

A partir da versatildeo V25 eacute possiacutevel cobrar MultaJuros para faturas antigas

(geradas antes da instalaccedilatildeo do moacutedulo) Essa opccedilatildeo soacute deve ser ativada em

uacuteltimo caso ( na duacutevida acione o suporte teacutecnico )

Exemplo abaixo fatura com vencimento em 29012017 e o cliente foi efetuar o

pagamento em 08022017 ou seja 10 dias em atraso

Seraacute calculado a multa por atraso + juros diaacuterios e armazenado localmente na

fatura

Na visualizaccedilatildeo do boleto natildeo haveraacute reincidecircncia da multa e apoacutes o vencimento soacute

haveraacute a cobranccedila dos juros diaacuterios (calculado automaticamente pela

boletobancariocom)

Duacutevidas sobre o caacutelculo consulte o artigo httpsbitlycomMultaJurosBoleto

Caso deseje (recomendaacutevel) habilitar a cobranccedila de MultaJuros

diretamente com a boletobancariocom habilite a opccedilatildeo (8) Caso a opccedilatildeo

esteja desmarcada seraacute cobrado multajuros localmente ( uma uacutenica vez )

Na opccedilatildeo (9) Detalhar MultaJuros eacute possiacutevel desabilitar o detalhamento

das informaccedilotildees

6

- Pagamento Antecipado (9) Permite oferecer um desconto (fixo ou percentual)

caso o cliente efetue o pagamento adiantado do boleto Ao utilizar essa opccedilatildeo recomendamos que ative a opccedilatildeo ldquoDesconto Antecipado (35)rdquo (paacutegina 12)

Informe no campo ldquoPagamento Antecipado (10)rdquo a quantidade de dias que o

desconto seraacute vaacutelido antes do vencimento do boleto exemplo 10 Caso o campo

esteja em branco ou com valor ldquo0rdquo natildeo haveraacute desconto Vocecirc pode optar por 2

tipos de desconto

- Percentual calculado sobre o valor total da fatura (sem taxataxa auxiliar) Caso

opte por desconto percentual ative a opccedilatildeo ldquoDesconto Percentual (11)rdquo e

informe no campo Valor do Desconto (12) o percentual de desconto exemplo

100= 1

Fatura R$ 10000 ndash 1= R$ 100

- Fixo desative a opccedilatildeo ldquoDesconto Percentualrdquo e informe no campo Valor do

Desconto o valor fixo do desconto exemplo 300= R$300

- Isentar (14) Isenta o cliente das taxas (taxa + taxa auxiliar) quando o valor total da fatura for

Natildeo eacute possiacutevel controlar a isenccedilatildeo de uma taxa individualmente

- Taxas taxa (15) de porcentagem sobre o total da fatura + Auxiliar (16)

( valor adicional somado a taxa de porcentagem )

7

Para uma fatura de R$ 10000 ( 5= R$500 + 100 ) = R$ 10600

Caso a opccedilatildeo ldquoDesabilitar Texto Taxasrdquo estiver habilitada o cliente natildeo

visualizaraacute os textos (1)

Para que o cliente visualizar a linha digitaacutevel marque a opccedilatildeo ldquoLinha Digitaacutevel

(17)rdquo

======================================================================================

- Campos Customizaacuteveis obrigatoriamente eacute necessaacuterio informar o CPFCNPJ

(vaacutelido natildeo importa como esteja cadastradoformatado) a Data Nascimento eacute opcional

Se vocecirc armazena o CPF e CNPJ em campos individuais basta selecionar e informar

se o CNPJ teraacute prioridade Se porventura os 1 dos campos estiverem preenchidos e

o campo com prioridade estiver ldquoem brancordquo o moacutedulo automaticamente iraacute enviar

os dados do campo que estive preenchido

Caso utilize o CPFCNPJ no mesmo campo preencha apenas o campo CPF ou

CNPJ (dispensando a configuraccedilatildeo do campo CNPJ e Priorizar CNPJ)

CPF do cliente ou CNPJ da empresa Deve conter 11 ou 14 caracteres

respectivamente

O moacutedulo iraacute remover automaticamente o que natildeo for nuacutemero

Caso o CPFCNPJ seja informado o sistema iraacute informar diretamente no

Sacado do Boleto

8

======================================================================================

- DestinataacuterioPagador (22) possibilita enviar o nomesobrenomeempresa de forma customizada

1- Nome e Sobrenome do cliente

2- Nome da Empresa (companyName)

3- Empresa ndash Nome e Sobrenome

4- Nome da Empresa ndash Nome

5- Verificar se o cliente estaacute utilizando um CPF ou CNPJ caso seja um CPF

seraacute fornecido o Nome e Sobrenome se CNPJ Nome da Empresa

Caso vocecirc tenha marcado a opccedilatildeo 2 (Nome da Empresa) e esse campo

esteja vazio automaticamente o sistema iraacute capturar os dados Nome e

Sobrenome

A partir da v30 seraacute possiacutevel determinar o CompanyNameNome da

Empresa atraveacutes de um campo customizaacutevel (23) a seu criteacuterio

======================================================================================

- Controle Transaccedilatildeo (24) permite configurar o status do retorno automaacutetico

Quando uma faturaboleto for pago e a BoletoBancariocom notificar o WHMCS eacute

possiacutevel exibir 5 status distintos

Exemplo

Satildeo 5 modelos

1) Pago Boleto Bancaacuterio - ID XXXX

2) Boleto Bancaacuterio - ID XXXX

3) Boleto Pago - ID XXXX

4) Pago - ID XXXX

5) ID XXXX

======================================================================================

- Notificaccedilatildeo Cliente (25) permite enviar uma notificaccedilatildeo para o cliente

A notificaccedilatildeoemail eacute efetuada pelo sistema da BoletoBancario conforme

exemplo

9

Utilize essa opccedilatildeo caso vocecirc natildeo utilize o WHMCS para envio de cobranccedilas

- Envio Dados Cadastrais (26) permite desabilitar o envio dos dados cadastrais (natildeo recomendaacutevel)

Seraacute enviado apenas os dados obrigatoacuterios Nome + CPFCNPJ do cliente

======================================================================================

- Ajuste Vencimento (27) atualiza o vencimento do boleto caso a fatura esteja vencida

Caso sua fatura esteja vencida o vencimento para pagamento via boleto seraacute

atualizado automaticamente para o dia corrente Com um diferencial se a fatura cair

no saacutebado ou domingo o vencimento eacute ajustado para segunda-feira

======================================================================================

- Ajuste Vencimento Domiacutenio (28) caso a fatura do cliente possua um item

relacionado a registrorenovaccedilatildeo de domiacutenio o moacutedulo natildeo permitiraacute o ajuste do

vencimento do boleto caso a fatura esteja vencida

Consequentemente se essa opccedilatildeo estiver habilitada natildeo seraacute possiacutevel oferecer

descontos multasjuros

======================================================================================

- Forccedilar Atualizaccedilatildeo (29) caso deseje efetuar a alteraccedilatildeo da fatura (valor ou

itens) deixe a opccedilatildeo desmarcada Assim vocecirc poderaacute reajustar a fatura a qualquer momento para atender situaccedilotildees especiais

10

Por solicitaccedilotildees dos usuaacuterios o ldquoAjuste Vencimento Localrdquo foi desabilitado

ou seja natildeo haveraacute alteraccedilatildeo do vencimento da fatura

Caso necessite forccedilar o vencimento do boleto basta alterar o valor da fatura

(negativamente ou positivamente) ou ative o Hook Ajuste Vencimento

Boleto (Paacutegina 21)

Caso a opccedilatildeo Cancelar Transaccedilotildees (30) esteja habilitada a cada geraccedilatildeo de nova

transaccedilatildeo (boleto expirado ou ajuste vencimento local) a transaccedilatildeo

anteriorantiga seraacute cancelada na boletobancariocom

No Log do sistema ficaraacute constando o cancelamento da transaccedilatildeo e no painel da

boletobancariocom a transaccedilatildeo seraacute arquivadacancelada

======================================================================================

Prazos acrescenta um prazo (em dias) a ser somado com o vencimento da fatura

Exemplo fatura vence em 10092016 e configuramos mais 1(um) dia de prazo

seu vencimento seraacute 11092016

O mesmo poderaacute ser aplicado para fatura jaacute vencida sendo que o vencimento seraacute

o dia corrente (dia que o cliente visualizar) + prazo que vocecirc determinar

Exemplo fatura venceu em 01092016 e configuramos mais 2(dois) dias de

prazo seu vencimento seraacute o dia corrente + 2 dias

Por padratildeo recomendamos que deixe ambos campos em branco

principalmente se vocecirc optar por aplicar multajuros

======================================================================================

- Itens Fatura (33) permite informar todos os itens + valores da fatura

diretamente no DEMONSTRATIVO ldquocabeccedilalho do boletordquo

Exemplo

Caso essa opccedilatildeo esteja desmarcada seraacute adicionado apenas uma referecircncia da

fatura atual

O limite maacuteximo definido pela BoletoBancariocom eacute de 400 caracteres

11

======================================================================================

- Link Direto (34) possibilita fornecer informaccedilotildees do boleto (vencimento + linha

digitaacutevel + link direto do boleto + taxas ) diretamente na fatura a ser enviada (por

email)

Apoacutes habilitar o campo acesse o email template e insira o campo

$invoice_payment_link nos emails templates

Exemplo

- Ocultar Link Direto (341) em casos de falhas de processamento agora vocecirc

poderaacute ocultar o link direto

======================================================================================

- Taxa Retorno (35) permite deduzir na fatura os custos do boleto (campo feestaxas) no momento do retorno automaacutetico (fatura pagaquitada)

12

- TaxasMultaJuros (36) permite incluir na fatura do cliente as taxasmultas

ou juros que o cliente tenha pago ldquoa maisrdquo

======================================================================================

- Desconto Antecipado (37) permite incluir na fatura o desconto pago sobre o total do boleto

Caso o cliente manipule o boleto e pague um valor inferior ao desconto real essa

opccedilatildeo natildeo seraacute aplicada Recomendamos que deixe ativo a opccedilatildeo ldquoFrauderdquo paacutegina

13

======================================================================================

- Redirecionar (38) possibilita o redirecionamento automaacutetico para o boleto

bancaacuterio quando o cliente visualizar a fatura finalizar um pedido ou ao efetuar um

pagamento em massa

Caso a opccedilatildeo Registro Impresso (39) esteja ativada o WHMCS iraacute registrar a

informaccedilatildeo ldquoBoleto Impresso ndash ID XXXXXrdquo aonde XXXX representa o ID do

documentonosso nuacutemero A opccedilatildeo (38) obrigatoriamente precisa estaacute ativa

======================================================================================

- URL do Botatildeo (40) possibilita transformar o botatildeo comum em imagem

Eacute possiacutevel definir o Alvo do Botatildeo (41)

Exemplo com imagem Exemplo sem imagem

13

- Observaccedilotildees (43) atraveacutes desse campo vocecirc poderaacute colocar uma observaccedilatildeo

para seu cliente o campo suporta HTML

Vocecirc pode habilitardesabilitar as observaccedilotildees clicando na opccedilatildeo ldquoExibir

Observaccedilotildees (42)rdquo

======================================================================================

- Fraude (44) Caso essa opccedilatildeo esteja ativa seraacute analisado o valor pago no boleto

x valor devido na fatura

Exemplo

Fatura R$ 5500 o cliente utilizou o campo Desconto (internet banking)

indevidamente e pagou R$ 5000

No momento do retorno automaacutetico natildeo haveraacute inclusatildeo de creacuteditotaxas

No Log ficaraacute constando ldquoFrauderdquo

Caso essa opccedilatildeo esteja desabilitada seraacute incluiacutedo o valor pago taxa descontada e a

fatura continuaraacute em aberto (com saldo a pagar)

14

Caso sua empresa adicione creacuteditos diretamente na fatura natildeo eacute

recomendaacutevel ativar essa opccedilatildeo

======================================================================================

- Debug (45) iraacute exibir 6 caixas de texto na visualizaccedilatildeo da fatura Seraacute

possiacutevel visualizar as informaccedilotildees do moacutedulo dados gerais dados locais requisiccedilatildeo enviada XML recebido e XML tratado

Apenas o administrador (logado) poderaacute visualizar o Debug o cliente natildeo

tem acesso

- Debug Retorno (46) possibilita uma anaacutelise completa das informaccedilotildees recebidas da BoletoBancariocom

Essa opccedilatildeo soacute deve ser habilitada apoacutes contato com o suporte

15

- Ativar SSL Retorno (47) Ative essa opccedilatildeo mediante orientaccedilatildeo do suporte

Caso vocecirc utilize SSL no WHMCS e por algum motivo (personalizaccedilatildeo htaccess

proxyfirewall e etc) sua URL de configuraccedilatildeo ( WHMCS System URL) natildeo possua

https eacute possiacutevel fazer com que o moacutedulo envie a URL com https

======================================================================================

- Sandbox (48) ambiente para testes na plataforma BoletoBancariocom

Na paacutegina 19 vocecirc encontra outras informaccedilotildees

Essa opccedilatildeo soacute deve ser habilitada apoacutes contato com o suporte apoacutes

ativaccedilatildeo a mensagem ldquoSandBox Ativardquo apareceraacute na fatura

16

RETORNO AUTOMAacuteTICO

Alguns clientes possuem caracteriacutesticas de negoacutecio que necessitam de uma validaccedilatildeo

manual para esses casos eacute possiacutevel desabilitar o retorno marque a opccedilatildeo ldquoRetorno

Automaacuteticordquo

O retorno automaacutetico soacute funciona apoacutes a compensaccedilatildeo (pagamento real do boleto)

Se porventura a fatura jaacute esteja Cancelada ou Paga o WHMCS iraacute receber o

retorno mas nenhuma accedilatildeo seraacute efetuada na fatura Assim evitando que a fatura

paga ou cancelada receba um creacutedito indevido

No Gateway Log seraacute informado em detalhes

Outras informaccedilotildees acesse httpbitlyFalhaRetornoBoletoFacil

- Data pagamento x Retorno Automaacutetico

Por padratildeo a data de quitaccedilatildeo da fatura seraacute o dia em que ocorrer o retorno

automaacutetico Com a opccedilatildeo 51 habilitada seraacute fornecido o dia em que o cliente quitou

o boleto

- Pagamento via Cartatildeo de Creacutedito

Aleacutem de receber atraveacutes do boleto bancaacuterio o moacutedulo permite o recebimento

atraveacutes de cartatildeo de creacutedito basta ativar a opccedilatildeo 52

Caso a opccedilatildeo 521 estiver habilitada vocecirc receberaacute os pagamentos via cartatildeo em

apenas 2 dias

17

TAXA EXCLUSIVA Agrave VISTA (479 + R$ 050 por transaccedilatildeo)

Se a opccedilatildeo 53 estiver habilitada o moacutedulo enviaraacute para o checkout do cartatildeo o

email do cliente visando facilitar o preenchimento automaacutetico

Vocecirc poderaacute definir uma imagem via URL (opccedilatildeo 54) e o alvo do botatildeo (opccedilatildeo 55)

vide exemplo abaixo

No checkout da boletobancariocom o cliente iraacute preencher o nuacutemero do cartatildeo

nome do titular validade do cartatildeo (mecircsano) e o CVV

Todos os clientes que utilizam o moacutedulo Boleto Faacutecil teratildeo taxas exclusivas confira

aqui

18

- Avisos Administrativos

Recomendamos que natildeo habilite a opccedilatildeo 56 caso ocorra algum pagamento

duplicado ou possiacutevel fraude vocecirc seraacute notificado por email exemplo

Alguns clientes desatentos pagam mais de 1 boleto gerado para a mesma fatura o

moacutedulo agora adicionaraacute um creacutedito para esse cliente e notificaraacute o administrador

(vocecirc) sobre esse pagamento duplicado Caso vocecirc esteja utilizando uma versatildeo do

WHMCS inferior a v72 seraacute necessaacuterio selecionar o administrador ( para utilizaccedilatildeo

da API interna do WHMCS )

Exemplo do email ndash Pagamento Duplicado

Em uma outra situaccedilatildeo bem comum ocorre um ajuste local na fatura (seja por

inclusatildeo de valores manuais ou multa do WHMCS) e com isso a fatura ficaraacute em

aberto agora vocecirc seraacute notificado

Exemplo do email ndash Suspeita de Fraude

No log dos meios de pagamento vocecirc poderaacute conferir o log completo da transaccedilatildeo

19

- URL checkout

Caso vocecirc utilize a Redirecionar (opccedilatildeo 38) vocecirc poderaacute optar por redirecionar para

o boleto direto

Ou se desejar que o redirecionamento seja para o checkout ( boleto + cartatildeo )

ative a (opccedilatildeo 58)

- Isentar Taxas

Aleacutem da (opccedilatildeo 5) isentar MultaJuros criamos uma nova (opccedilatildeo 59) para isentar a

cobranccedila da taxa percentual (opccedilatildeo 15) + taxa auxiliar (opccedilatildeo 16)

20

- Nuacutemero da Residecircncia (60)

O WHMCS por padratildeo natildeo armazena nuacutemero da residecircncia (endereccedilo) o moacutedulo

tenta capturar atraveacutes do endereccedilo tudo que for nuacutemero e fornece para

boletobancariocom ( por isso em ocorre a duplicaccedilatildeo de endereccedilo + nuacutemero )

Caso vocecirc possua um campo customizaacutevel jaacute configurado e jaacute armazena essa

informaccedilatildeo separada agora seraacute possiacutevel configurar diretamente no moacutedulo

21

- Faturas Pagas (61)

Caso vocecirc faccedila confirmaccedilotildees de pagamento manualmente eacute recomendaacutevel

habilitar essa opccedilatildeo para que natildeo ocorra um novo creacutedito quando o retorno

automaacutetico da boletobancariocom for enviado a seu WHMCS

- Complemento Endereccedilo (62)

Similar agrave opccedilatildeo (60) agora vocecirc poderaacute informar um complemento de endereccedilo

- Boleto Transparente (63)

Seu cliente teraacute acesso ao boleto diretamente no WHMCS sem precisar visitor o site

da boletobancariocomJuno

Veja exemplo neste link

- Envio PDF por Email (63)

Permite anexar o boleto em PDF diretamente nos emails de faturas (nova cobranccedila

lembretes avisos de atraso)

Visite o link httpswwwedvancombrBoletoNoEmail e saiba como ativar

esse recurso

22

- Hook Remoccedilatildeo de Multa WHMCS

Alguns clientes cobram multa por atraso no WHMCS e por padratildeo natildeo eacute possiacutevel

determinar quais formas de pagamento devem ser cobradas

Criamos um hook para WHMCS que iraacute remover a multa automaticamente da fatura

( que possua o moacutedulo boleto faacutecil habilitado ) assim vocecirc continuaraacute cobrando

multa de outras formas de pagamento e cobraraacute diretamente do moacutedulo boleto

faacutecil recomendamos essa configuraccedilatildeo

Para habilitar o hook vaacute na pasta includeshooks e renomeie o arquivo

removermultaboletofacildesabilitado para removermultaboletofacilphp

- Hook Ajuste Vencimento Boleto

Apoacutes emissatildeogeraccedilatildeo do boleto natildeo eacute possiacutevel alterar o vencimento pois o boleto

agora eacute registrado e dispensa alteraccedilatildeo do vencimento seu cliente poderaacute pagar o

boleto mesmo estando vencido

Se vocecirc precisar mesmo assim alterar o vencimento do boleto ou alterar a

descriccedilatildeo dos itensvalores temos uma alternativa

Abra a na pasta includeshooks e renomeie o arquivo

ajustevencimentoboletofacildesabilitado para

ajustevencimentoboletofacilphp

Recomendamos que ative a opccedilatildeo 30 no moacutedulo

Assim quando vocecirc alterar o vencimento local no WHMCS e seu cliente for

visualizar a fatura seraacute cancelado o boleto anterior e ficaraacute constando o novo

boleto

23

SUPORTEDUacuteVIDAS

Duacutevidas sugestotildees ou problemas referente ao moacutedulo Boleto para WHMCS entre

em contato atraveacutes do link httpsuporteedvancombr

PERGUNTASRESPOSTAS

P= Eacute possiacutevel cadastrar a logomarca da empresa no boleto

R= Sim No painel da BoletoBancariocom vaacute no menu lateral (1) e clique no seu

nomenome da empresa em seguida clique em (2) Trocar Logotipo

P= Eacute possiacutevel personalizar as instruccedilotildees do boleto

R= Natildeo por enquanto a API ou painel natildeo possibilita personalizaccedilotildees

P= Gostaria de personalizar as mensagens exibidas na fatura eacute possiacutevel

R= Sim eacute possiacutevel Acesse a pasta modulesgatewaysboletofacil e edite o

arquivo textosphp (recomendaacutevel utilizar um editor de coacutedigos)

P= Quando o cliente vai efetuar um pagamento aparece a mensagem ldquoFalha

Processamentordquo

R= Esse problema ocorre quando alguma configuraccedilatildeo em seu moacutedulo natildeo estaacute

correta

Nos exemplo abaixo o TOKEN cadastrado no moacutedulo estaacute invaacutelido e a fatura do

cliente estaacute vencida

Verifique o TOKEN e para o problema da fatura vocecirc tem 2 opccedilotildees

- Atualizar o vencimento da fatura

24

- Efetuar o ajuste automaacutetico do vencimento

P= No perfil do meu cliente natildeo consta os camposdados CPF Data de Nascimento

R= Recomendamos que crie os campos customizaacuteveis

P= Gostaria de personalizar a formataccedilatildeo da multajuros (local) eacute possiacutevel

R= Sim eacute possiacutevel Acesse a pasta modulesgatewaysboletofacil e edite o

arquivo multajurosphp (recomendaacutevel utilizar um editor de coacutedigos)

P= Existe alguma restriccedilatildeo na utilizaccedilatildeo do moacutedulo Boleto FaacutecilJuno para cartatildeo

de creacutedito

R= Sim clique aqui

P= Quais satildeo as taxas para cartatildeo de creacutedito

R= confira aqui

P= Existe algum tutorial sobre problemas com retorno automaacutetico

R= confira aqui

P= Minha duacutevida natildeo foi esclarecida

R= acesse faqedvancombr ou entre em contato com suporteedvancombr

25

WIDGET SALDO BOLETOBANCARIOCOM

Conforme prometido estou disponibilizando gratuitamente um WidGet para consulta

de saldo (API produccedilatildeo ou SandBox) e a possibilidade de efetuar o saque em 1 clique

(solicitaccedilatildeo seraacute processada no painel da boletobancariocom) caso o valor seja

superior a 000

O Widget dispensa configuraccedilatildeo pois apoacutes configurar o moacutedulo seraacute utilizado as

credenciais da API de forma automaacutetica

A ativaccedilatildeo eacute simples siga os passos

Menu Configuraccedilotildees gtgt Gerenciamento Equipe gtgt Regras dos

Administradores

Edite o grupo correspondente ao seu usuaacuterio

No final da paacutegina localize a sessatildeo Widgets procure por Saldo

BoletoBancariocom e habilite a opccedilatildeo salve as alteraccedilotildees

Pronto WidGet instalado

Na paacutegina principal do admin WHMCS vocecirc veraacute o Saldo

26

SANDBOX

Atraveacutes da SandBox vocecirc poderaacute simular pagamentos para testar o ciclo completo

do boleto

Acesse httpssandboxboletobancariocomboletofacilusersignuphtml e crie um

novo cadastro

Em seguida acesse o menu Integraccedilatildeo gtgt Token ou acesse

httpssandboxboletobancariocomboletofacilintegrationintegrationhtmltoken

Clique Gerar Token

Insira o token no campo Token SanBox (49) e habilite a opccedilatildeo Sandbox (48)

Pronto agora vocecirc poderaacute simular um pagamento

1) Emita uma fatura com valor miacutenimo R$ 250 ou no maacuteximo R$ 35000

2) Visualize a fatura (natildeo eacute necessaacuterio visualizar o boleto)

3) No painel da SandBox acesse o menu Cobranccedilas (1) e localize a transaccedilatildeo

gerada Clique em Accedilotildees (2) e escolha a opccedilatildeo Simular Pagamento (3) aguarde

de 30 segundos agrave 2 minutos e o retorno automaacutetico seraacute enviado

automaticamente

27

Ao visualizar a fatura vocecirc veraacute que a mesma jaacute estaacute paga

No log do retorno vocecirc poderaacute obter outras informaccedilotildees

Atualizaccedilatildeo 29012020 ndash 0755h