8 : 45 Minutos

FTP Caseiro

Aprenda, de forma prática, a construir boletos bancários válidos

Comprar pela Internet é um hábito que se torna mais popular a cada dia. Mas o grande obstáculo para que muitos façam suas compras virtualmente é a segurança em realizar transações bancárias on-line. Dessa forma,

os boletos bancários se tornaram amplamente utilizados pelas lojas virtuais. Eles são seguros: o comprador pode optar entre efetuar o pagamento on-line ou dirigir-se a um local para fazer o pagamento e não é necessário possuir cartão de crédito.

Cada banco disponibiliza, para os desenvolvedores, layouts, regras e documentações que devem ser seguidas, afim de que o boleto seja considerado válido pelas instituições bancárias. É tarefa do desenvolvedor implantar os itens da melhor for-ma possível, seguindo e respeitando as regras de cada banco. Você pode procurar e adquirir as regras e documentações de seu banco, basta entrar em contato com as áreas de desenvol-vimento ou soluções de e-commerce.

Neste tutorial, abordaremos o desenvolvimento de um bo-leto bancário do banco Bradesco, seguindo o layout forne-cido pela instituição, que você pode encontrar no CD da re-vista. Utilizando a linguagem PHP, a biblioteca BoletoPHP, o Dreamweaver como editor e um servidor local (que você pode montar em seu próprio computador), desenvolveremos, do início ao fim, um boleto profissional e válido. Certifique-se de que a biblioteca GD do PHP esteja compilada, pois ela será a responsável pela geração do código de barras do boleto.

A biblioteca BoletoPHP é um projeto brasileiro, gratuito, criado para simplificar a construção de boletos bancários, bem como para incentivar a compra eletrônica e fortalecer o co-mércio virtual no nosso país. Você pode encontrar a biblioteca completa no CD. Também estão inclusos no pacote layouts de vários dos bancos mais conhecidos.

Basicamente, trabalharemos com quatro arquivos princi-pais, três encontrados no pacote do BoletoPHP e um quarto, criado para os testes de geração do boleto.

São eles:• boleto_bradesco.php – Este arquivo contém os dados do

Gerando boletos bancários

banco, usados para a geração de boletos;• layout_bradesco.php – Este é o arquivo onde fica a estru-

tura HTML para a geração de boleto no formato on-line;• funcoes_bradesco.php – Aqui, ficam as funções utilizadas

para a geração de boletos;• cliente_teste.php – Arquivo que criaremos afim de testar

a passagem de parâmetros do formulário para o boleto.A geração de um boleto bancário válido é composta por al-

guns fatores principais: código de barras no padrão Febraban (Federação Brasileira de Bancos), linha digitável para paga-mento via Internet banking, número de controle único para cada boleto gerado, dados do sacador (quem está emitindo o boleto) e dados do sacado (quem está pagando o boleto).

No tutorial a seguir, usaremos um formulário que passe os dados para o boleto a ser gerado. Porém, caso você tenha uma loja virtual pronta, basta passar dinamicamente os dados de seu cliente, valor e número de pedido, diretamente para o bo-leto. As possibilidades são ilimitadas!Descompacte o conteúdo do pacote BoletoPHP em um dire-tório em seu servidor local (ou on-line, caso opte por um ser-vidor de hospedagem) e localize os arquivos mencionados acima. Assim, estaremos prontos para começar!

Por Flávia Jobstraibizer

08-13 forma pagamento-REV.indd 808-13 forma pagamento-REV.indd 8 17/8/2007 13:02:5117/8/2007 13:02:51

45 Minutos : 9

1 – Conheça e se familiarize com a estrutura de diretórios do pa-cote BoletoPHP. Na pasta imagens, estão os logotipos dos ban-cos, na include, as funções e layouts. Na raiz, os boletos.

2 – Crie um documento no Dreamweaver, chamado cliente_teste.php e construa um formulário, no qual passaremos as in-formações de compra para o boleto bancário que será gerado.

3 – Na ação (action) desse formulário criado, chamaremos o arquivo layout_bradesco.php e passaremos os dados do for-mulário para esta página, po meio do método post.

4 – Agora, abra o arquivo boleto_bradesco.php. Vamos recupe-rar, neste arquivo, os dados que passamos por meio do formulá-rio da página criada anteriormente, conforme a imagem.

5 – Editaremos os parâmetros de configuração do boleto, de acordo com os dados recebidos do formulário. O primeiro é o valor da compra, que será recebido através da variável $valor.

6 – Caso você tenha alterado o valor da taxa sobre geração de boleto bancário, ela será somada ao valor da compra, na linha onde se encontra a variável $valor_boleto.

08-13 forma pagamento-REV.indd 908-13 forma pagamento-REV.indd 9 17/8/2007 13:03:1217/8/2007 13:03:12

10 : 45 Minutos

FTP Caseiro

7 – O nosso_numero é uma informação exigida pelo banco e deve ser única para cada boleto gerado. Para tanto, usaremos o número do pedido para gerar esse algarismo único.

8 – A data de vencimento será calculada a partir de uma data de geração do boleto, mais os dias informados na variável $dias_de_prazo_para_pagamento. Altere os valores, se necessário.

9 – Agora, resgatamos os dados do cliente, que recebemos do formulário na seção de informações sobre o sacado do boleto bancário, conforme a figura.

10 – Nas próximas linhas, que são referentes ao caixa do banco e às informações da loja e do cliente, edite da forma que lhe for mais conveniente.

11 – Existem algumas linhas referentes à moeda de cobrança e configurações opcionais de acordo com o banco. Geralmente, não é necessário alterar esse trecho.

12 – Agora, informamos seus dados bancários. Número de agência e conta e seus respectivos dígitos. É onde serão creditadas as compensações dos boletos quitados.

08-13 forma pagamento-REV.indd 1008-13 forma pagamento-REV.indd 10 17/8/2007 13:03:1417/8/2007 13:03:14

45 Minutos : 11

13 – Adiante, configuramos as informações referentes à conta e à carteira de cobrança. Essa carteira é o método de pagamento via boleto sem registro do banco Bradesco e seu número é seis.

14 – O último trecho de configuração desse arquivo refere-se aos dados da loja ou de quem está emitindo o boleto bancário. Preen-cha corretamente, de acordo com as informações desejadas.

15 – Note que as duas linhas mostradas na imagem são as res-ponsáveis por incluir os arquivos do layout e funções do boleto dentro do arquivo boleto_bradesco.php. Não edite essas linhas.

16 – Em funcoes_bradesco.php, não é necessário efetuar mo-dificações, mas conheceremos as principais tarefas desse ar-quivo, como a variável que monta a linha digitável.

17 – Nesta imagem, a interessante função responsável por gerar o código de barras está presente desde a linha 128 à 153 do arquivo. Não é necessário modificar nada.

18 – O trecho que desenha o código de barras em formato de imagem vai desde a linha 160 à 201. Esse trecho “desenha” o có-digo na tela, conforme os dados do boleto_bradesco.php.

08-13 forma pagamento-REV.indd 1108-13 forma pagamento-REV.indd 11 17/8/2007 13:03:1617/8/2007 13:03:16

12 : 45 Minutos

FTP Caseiro

19 – A variável mostrada é utilizada pela função monta_linha_digitavel, presente na linha 329 do arquivo de funções. Note, nos comentários, as instruções para melhor entendimento.

20 – Abra o arquivo layout_bradesco.php e note que, no ínicio, estão presentes instruções para impressão. Alguns bancos obri-gam que elas sejam seguidas, afim de tornar o boleto válido.

21 – Nas linhas 57 e 58 do arquivo, podemos encontrar a va-riável que gera a linha digitável do boleto, a partir do arquivo de funções, e a variável que imprime o valor do documento.

22 – Mais abaixo, temos outros valores resgatados do ar-quivo boleto_bradesco.php: as informações de quem está emitindo o boleto bancário, ou seja, as suas informações.

23 – A seguir, temos o logotipo do banco. Ele é posiciona-do em dois locais: na ficha de compensação, que fica retida no banco e, após o picote, na via que é do cliente.

24 – O layout completo recebe, em cada local apropriado e de acordo com o exigido pelo banco Bradesco, seus valores correspondentes, como mostrados na imagem.

08-13 forma pagamento-REV.indd 1208-13 forma pagamento-REV.indd 12 17/8/2007 13:03:1917/8/2007 13:03:19

45 Minutos : 13

25 – O local reservado ao código de barras recebe a chamada da função responsável por desenhá-la, no local exigido pelo banco. O arquivo de funções saberá onde imprimir o código de barras.

26 – Abra no navegador o arquivo cliente_teste.php, cria-do anteriormente com o formulário de testes. Preencha-o com as informações necessárias e clique em Gerar boleto.

27 – O resultado é o boleto bancário gerado corretamente, com as informações de quem emite, do cliente, uma linha di-gitável válida para pagamento on-line, código de barras etc.

28 – Atente para o valor do boleto bancário. Não se esqueça que após a geração do boleto foi acrescido o valor da taxa de co-brança, conforme informado no arquivo boleto_bradesco.php.

29 – Você pode retirar o logotipo do projeto BoletoPHP do topo de seu boleto bancário, mas é interessante manter os comentá-rios dentro dos arquivos de scripts, para apoiar o projeto.

30 – É importante se lembrar também que as fontes (letras) não devem ser modificadas, pois nenhum banco aceita boletos gera-dos em fontes detalhadas ou desenhadas, conforme a imagem.

08-13 forma pagamento-REV.indd 1308-13 forma pagamento-REV.indd 13 17/8/2007 13:03:2117/8/2007 13:03:21