Módulo Boleto Fácil | Juno para WHMCS v4 · 2020-04-29 · ( valor adicional somado a taxa de...
Transcript of Módulo Boleto Fácil | Juno para WHMCS v4 · 2020-04-29 · ( valor adicional somado a taxa de...
![Page 1: Módulo Boleto Fácil | Juno para WHMCS v4 · 2020-04-29 · ( valor adicional somado a taxa de porcentagem )! ... Exemplo, fatura vence em 10/09/2016 e configuramos mais 1(um) dia](https://reader035.fdocumentos.com/reader035/viewer/2022080721/5f7b516e523a274be62a7424/html5/thumbnails/1.jpg)
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
![Page 2: Módulo Boleto Fácil | Juno para WHMCS v4 · 2020-04-29 · ( valor adicional somado a taxa de porcentagem )! ... Exemplo, fatura vence em 10/09/2016 e configuramos mais 1(um) dia](https://reader035.fdocumentos.com/reader035/viewer/2022080721/5f7b516e523a274be62a7424/html5/thumbnails/2.jpg)
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
![Page 3: Módulo Boleto Fácil | Juno para WHMCS v4 · 2020-04-29 · ( valor adicional somado a taxa de porcentagem )! ... Exemplo, fatura vence em 10/09/2016 e configuramos mais 1(um) dia](https://reader035.fdocumentos.com/reader035/viewer/2022080721/5f7b516e523a274be62a7424/html5/thumbnails/3.jpg)
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
![Page 4: Módulo Boleto Fácil | Juno para WHMCS v4 · 2020-04-29 · ( valor adicional somado a taxa de porcentagem )! ... Exemplo, fatura vence em 10/09/2016 e configuramos mais 1(um) dia](https://reader035.fdocumentos.com/reader035/viewer/2022080721/5f7b516e523a274be62a7424/html5/thumbnails/4.jpg)
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
![Page 5: Módulo Boleto Fácil | Juno para WHMCS v4 · 2020-04-29 · ( valor adicional somado a taxa de porcentagem )! ... Exemplo, fatura vence em 10/09/2016 e configuramos mais 1(um) dia](https://reader035.fdocumentos.com/reader035/viewer/2022080721/5f7b516e523a274be62a7424/html5/thumbnails/5.jpg)
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
![Page 6: Módulo Boleto Fácil | Juno para WHMCS v4 · 2020-04-29 · ( valor adicional somado a taxa de porcentagem )! ... Exemplo, fatura vence em 10/09/2016 e configuramos mais 1(um) dia](https://reader035.fdocumentos.com/reader035/viewer/2022080721/5f7b516e523a274be62a7424/html5/thumbnails/6.jpg)
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
![Page 7: Módulo Boleto Fácil | Juno para WHMCS v4 · 2020-04-29 · ( valor adicional somado a taxa de porcentagem )! ... Exemplo, fatura vence em 10/09/2016 e configuramos mais 1(um) dia](https://reader035.fdocumentos.com/reader035/viewer/2022080721/5f7b516e523a274be62a7424/html5/thumbnails/7.jpg)
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
![Page 8: Módulo Boleto Fácil | Juno para WHMCS v4 · 2020-04-29 · ( valor adicional somado a taxa de porcentagem )! ... Exemplo, fatura vence em 10/09/2016 e configuramos mais 1(um) dia](https://reader035.fdocumentos.com/reader035/viewer/2022080721/5f7b516e523a274be62a7424/html5/thumbnails/8.jpg)
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
![Page 9: Módulo Boleto Fácil | Juno para WHMCS v4 · 2020-04-29 · ( valor adicional somado a taxa de porcentagem )! ... Exemplo, fatura vence em 10/09/2016 e configuramos mais 1(um) dia](https://reader035.fdocumentos.com/reader035/viewer/2022080721/5f7b516e523a274be62a7424/html5/thumbnails/9.jpg)
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
![Page 10: Módulo Boleto Fácil | Juno para WHMCS v4 · 2020-04-29 · ( valor adicional somado a taxa de porcentagem )! ... Exemplo, fatura vence em 10/09/2016 e configuramos mais 1(um) dia](https://reader035.fdocumentos.com/reader035/viewer/2022080721/5f7b516e523a274be62a7424/html5/thumbnails/10.jpg)
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
![Page 11: Módulo Boleto Fácil | Juno para WHMCS v4 · 2020-04-29 · ( valor adicional somado a taxa de porcentagem )! ... Exemplo, fatura vence em 10/09/2016 e configuramos mais 1(um) dia](https://reader035.fdocumentos.com/reader035/viewer/2022080721/5f7b516e523a274be62a7424/html5/thumbnails/11.jpg)
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
![Page 12: Módulo Boleto Fácil | Juno para WHMCS v4 · 2020-04-29 · ( valor adicional somado a taxa de porcentagem )! ... Exemplo, fatura vence em 10/09/2016 e configuramos mais 1(um) dia](https://reader035.fdocumentos.com/reader035/viewer/2022080721/5f7b516e523a274be62a7424/html5/thumbnails/12.jpg)
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
![Page 13: Módulo Boleto Fácil | Juno para WHMCS v4 · 2020-04-29 · ( valor adicional somado a taxa de porcentagem )! ... Exemplo, fatura vence em 10/09/2016 e configuramos mais 1(um) dia](https://reader035.fdocumentos.com/reader035/viewer/2022080721/5f7b516e523a274be62a7424/html5/thumbnails/13.jpg)
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
![Page 14: Módulo Boleto Fácil | Juno para WHMCS v4 · 2020-04-29 · ( valor adicional somado a taxa de porcentagem )! ... Exemplo, fatura vence em 10/09/2016 e configuramos mais 1(um) dia](https://reader035.fdocumentos.com/reader035/viewer/2022080721/5f7b516e523a274be62a7424/html5/thumbnails/14.jpg)
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
![Page 15: Módulo Boleto Fácil | Juno para WHMCS v4 · 2020-04-29 · ( valor adicional somado a taxa de porcentagem )! ... Exemplo, fatura vence em 10/09/2016 e configuramos mais 1(um) dia](https://reader035.fdocumentos.com/reader035/viewer/2022080721/5f7b516e523a274be62a7424/html5/thumbnails/15.jpg)
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
![Page 16: Módulo Boleto Fácil | Juno para WHMCS v4 · 2020-04-29 · ( valor adicional somado a taxa de porcentagem )! ... Exemplo, fatura vence em 10/09/2016 e configuramos mais 1(um) dia](https://reader035.fdocumentos.com/reader035/viewer/2022080721/5f7b516e523a274be62a7424/html5/thumbnails/16.jpg)
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
![Page 17: Módulo Boleto Fácil | Juno para WHMCS v4 · 2020-04-29 · ( valor adicional somado a taxa de porcentagem )! ... Exemplo, fatura vence em 10/09/2016 e configuramos mais 1(um) dia](https://reader035.fdocumentos.com/reader035/viewer/2022080721/5f7b516e523a274be62a7424/html5/thumbnails/17.jpg)
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
![Page 18: Módulo Boleto Fácil | Juno para WHMCS v4 · 2020-04-29 · ( valor adicional somado a taxa de porcentagem )! ... Exemplo, fatura vence em 10/09/2016 e configuramos mais 1(um) dia](https://reader035.fdocumentos.com/reader035/viewer/2022080721/5f7b516e523a274be62a7424/html5/thumbnails/18.jpg)
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
![Page 19: Módulo Boleto Fácil | Juno para WHMCS v4 · 2020-04-29 · ( valor adicional somado a taxa de porcentagem )! ... Exemplo, fatura vence em 10/09/2016 e configuramos mais 1(um) dia](https://reader035.fdocumentos.com/reader035/viewer/2022080721/5f7b516e523a274be62a7424/html5/thumbnails/19.jpg)
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
![Page 20: Módulo Boleto Fácil | Juno para WHMCS v4 · 2020-04-29 · ( valor adicional somado a taxa de porcentagem )! ... Exemplo, fatura vence em 10/09/2016 e configuramos mais 1(um) dia](https://reader035.fdocumentos.com/reader035/viewer/2022080721/5f7b516e523a274be62a7424/html5/thumbnails/20.jpg)
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
![Page 21: Módulo Boleto Fácil | Juno para WHMCS v4 · 2020-04-29 · ( valor adicional somado a taxa de porcentagem )! ... Exemplo, fatura vence em 10/09/2016 e configuramos mais 1(um) dia](https://reader035.fdocumentos.com/reader035/viewer/2022080721/5f7b516e523a274be62a7424/html5/thumbnails/21.jpg)
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
![Page 22: Módulo Boleto Fácil | Juno para WHMCS v4 · 2020-04-29 · ( valor adicional somado a taxa de porcentagem )! ... Exemplo, fatura vence em 10/09/2016 e configuramos mais 1(um) dia](https://reader035.fdocumentos.com/reader035/viewer/2022080721/5f7b516e523a274be62a7424/html5/thumbnails/22.jpg)
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
![Page 23: Módulo Boleto Fácil | Juno para WHMCS v4 · 2020-04-29 · ( valor adicional somado a taxa de porcentagem )! ... Exemplo, fatura vence em 10/09/2016 e configuramos mais 1(um) dia](https://reader035.fdocumentos.com/reader035/viewer/2022080721/5f7b516e523a274be62a7424/html5/thumbnails/23.jpg)
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
![Page 24: Módulo Boleto Fácil | Juno para WHMCS v4 · 2020-04-29 · ( valor adicional somado a taxa de porcentagem )! ... Exemplo, fatura vence em 10/09/2016 e configuramos mais 1(um) dia](https://reader035.fdocumentos.com/reader035/viewer/2022080721/5f7b516e523a274be62a7424/html5/thumbnails/24.jpg)
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
![Page 25: Módulo Boleto Fácil | Juno para WHMCS v4 · 2020-04-29 · ( valor adicional somado a taxa de porcentagem )! ... Exemplo, fatura vence em 10/09/2016 e configuramos mais 1(um) dia](https://reader035.fdocumentos.com/reader035/viewer/2022080721/5f7b516e523a274be62a7424/html5/thumbnails/25.jpg)
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
![Page 26: Módulo Boleto Fácil | Juno para WHMCS v4 · 2020-04-29 · ( valor adicional somado a taxa de porcentagem )! ... Exemplo, fatura vence em 10/09/2016 e configuramos mais 1(um) dia](https://reader035.fdocumentos.com/reader035/viewer/2022080721/5f7b516e523a274be62a7424/html5/thumbnails/26.jpg)
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
![Page 27: Módulo Boleto Fácil | Juno para WHMCS v4 · 2020-04-29 · ( valor adicional somado a taxa de porcentagem )! ... Exemplo, fatura vence em 10/09/2016 e configuramos mais 1(um) dia](https://reader035.fdocumentos.com/reader035/viewer/2022080721/5f7b516e523a274be62a7424/html5/thumbnails/27.jpg)
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