módulo boleto fácil | juno para whmcs v4 · 2020-04-29 · ( valor adicional somado a taxa de...
TRANSCRIPT
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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