MANUAL DE INSTRUÇÕES PARA GERAÇÃO DE BOLETOS ATRAVÉS DE URL
OU VIA FORM/POST
ATENÇÃO: Recomendamos fortemente aos nossos clientes que uilizem o Sistema BoletoStore, que configura automaticamente o formulário de geração dos boletos.
Os sistemas abaixo descritos são destinados a pessoas com experiência em desenvolvimento de sistemas Web e o domínio de alguma linguagem (.NET, JAVA, PHP, etc)
A forma mais segura de gerar seu boleto é através de FORM/POST. Gerando seu boleto através de URL ou FORM/GET os parametros utilizados na geração do boleto ficam completamente expostos ao usuário, que pode, p.ex. modificar o valor do boleto.
No caso de você realmente necessitar gerar via URL ou via FORM/GET, voce deve requisitar a liberação para gerar boletos como referer vazio, enviando um email para atendimento@boletomail.com.br, caso contrário você receberá uma mensagem de erro (Erro: referer vazio) ao enviar os parâmetros do boleto.


(*) Geracao SEGURA do boleto: Uma forma altamente segura para se gerar um boleto é o seu sistema passar internamenteos dados via URL e o action=5 (no PHP utilize a funcao fopen). Com action=5 o sistema dará um echo com uma url com o link para o boleto, onde não constam os seus parametros. Redirecione seu cliente para este link para que ele possa gerar o boleto.
Exemplo: dê um fopen na url: http://www.boletomail.com.br/do.php?nossonum=123456&valor=125,98&v_dia=31&v_mes=12&v_ano=2010&user=vamonessa&action=5
O sistema retornará com uma url do tipo: http://www.boletomail.com.br/do.php?hash=0f23ecf1d75fcfe758383c2706ec7556
Note que na URL acima não constam os dados do boleto. Redirecione o seu cliente para o link acima para que ele possa gerar o boleto on-line.

Codigo-fonte em PHP:
/* abre a url com os parametros do boleto */
$fd=fopen ("http://www.boletomail.com.br/do.php?nossonum=123456&valor=125,98&v_dia=31&v_mes=12&v_ano=2010&user=vamonessa&action=5", "r");
if (!$fd){
   die("Erro, verifique se a url fornecida esta correta.");
}else{
   $urlBoleto = fgets($fd, 4096);
   /* redireciona para o boleto */
   header("Location: ".$urlBoleto);
}


Codigo-fonte em ASP:
Dim objInet As Inet  
Set objInet = New Inet
strUrlBoleto = objInet.OpenURL("http://www.boletomail.com.br/do.php?nossonum=123456&valor=125,98&v_dia=31&v_mes=12&v_ano=2010&user=vamonessa&action=5")
Response.Redirect(strUrlBoleto)
Abaixo estão listados os campos obrigatórios que devem estar presentes no seu formulário ou na sua URL para gerar um BoletoMail:
Os dados devem ser postados para o endereço: http://www.boletomail.com.br/do.php
Campos obrigatórios: exemplo Observações:
nossonum 123456 É o nosso número - IMPORTANTE - o nosso número deve ser único para cada boleto emitido. A sua repetição pode impossibilitar a identificação do sacado.
Deve ser fornecido SEM símbolos (- / #) e SEM o dígito verificador
Dica: habilite a sua numeração automática, assim voce não precisa mais informar o nosso número para gerar os boletos.
valor 125,98 É o valor do boleto - informar SEM símbolos e sem separador de milhar.
v_dia 31 É o dia do vencimento do boleto.
v_mes 12 É o mês do vencimento do boleto.
v_ano 2000 É o ano do vencimento do boleto (com quatro dígitos).
user vamonessa É o seu username no boletoServer
action 3

1   para display (apenas gera o boleto on line)

2   para email (apenas manda o boleto via email sem display)

3   para display+email (gera o boleto on line e envia via email)

Exemplo de formulário com os dados obrigatórios:

<html>
<body>
<form action="http://www.boletomail.com.br/do.php" method="POST">
Nosso Numero: <input type="text" name="nossonum" value="123456"><BR>
Valor: <input type="text" name="valor" value="125,98"><BR>
Dia: <input type="text" name="v_dia" value="31">&nbsp;
Mes: <input type="text" name="v_mes" value="12">&nbsp;
Ano: <input type="text" name="v_ano" value="2000">&nbsp;
<input type="hidden" name="user" value="vamonessa"><!--coloque aqui o seu username -->
<input type="hidden" name="action" value="1"><BR>
<input type="submit">
</form>
</body>
</html>

Exemplo de URL com os campos obrigatórios:

http://www.boletomail.com.br/do.php?nossonum=123456&valor=125,98
&v_dia=31&v_mes=12&v_ano=2000&user=vamonessa&action=3

 
Campos opcionais: exemplo Observações:
nome Figueiredo+Ferraz   (*) Nome do sacado
cod_cli 123-AG (*) Código do cliente que o identifica no seu sistema. É usado para você controlar mais facilmente os boletos pagos.
mailto fferraz@dot.com (*) email do sacado, necessário no caso de action=2 ou action=3.
instr Não+receber+após+
o+vencimento   (*) 		Instruções - no caso de ser informado, substitui as constantes no boletoServer
numdoc2 552626 Número do documento
d_dia 12 Dia da data do documento
d_mes 11 Mês da data do documento
d_ano 2000 Ano da data do documento (4 digitos)
p_dia 13 Dia da data de processamento
p_mes 11 Mês da data de processamento
p_ano 2000 Ano da data de processamento (4 digitos)
cod_config UNI Código de configuração do boletoServer -
Se você tem mais de uma configuração no BoletoServer, você deve informar seu código de configuração.
Para a maioria dos cliente BoletoMail este campo deve ser deixado em branco.
IMPORTANTE:
(*)Caso você esteja gerando seus boletos via URL, todos os caracteres não-alfanuméricos desses campos devem ser codificados conforme o padrão application/x-www-form-urlencode (no PHP3 usar a função urlencode)

BOLETOSTORE CLASSIC

Caso você tenha dificuldades em fornecer a data de vencimento para a geração do boleto e também gostaria de receber um email com os dados da compra, você pode utilizar o BoletoStore Classic.

Funciona basicamente como a geração de boletos via formulário, mas voce não precisa fornecer a data de vencimento do boleto, o sistema calcula automaticamente a data de vencimento somando a data atual ao parametro dias_venc.
Assim, p.ex, se voce deseja que seus boletos vencam 5 dias após a data da compra, basta configurar dias_venc=5.
Voce também deverá acrescentar o seguinte parametro: store=yes.
Também é obrigatório informar o nome do comprador no parâmetro nome.
Além disso voce pode acrescentar livremente outras variáveis que sejam necessárias, p.ex: Endereco, cidade, estado, cep, ddd, telefone(...) Os valores de todas as variáveis que voce colocar no formulário serão enviadas no email com os dados da compra.
Se voce desejar que seu cliente também receba o boleto via email, coloque action=3 e o parametro email no formulário.
Para utilizar o BoletoStore Classic voce deve habilitar a numeração automática, enviando um email para atendimento@boletomail.com.br

Segue abaixo um exemplo de Formulário BoletoStore Classic:

<html>
<body>
<form action="http://www.boletomail.com.br/do.php" method="POST">
Valor: <input type="text" name="valor" value="125,98"><BR>
Nome: <input type="text" name="nome" value="Jose da Silva"><BR>
email: <input type="text" name="email" value="atendimento@boletomail.com.br"><BR>
Endereco: <input type="text" name="endereco" value="AV Pedroso de Morais 631"><BR>
Cidade: <input type="text" name="cidade" value="Sao Paulo"><BR>
UF: <input type="text" name="UF" value="SP"><BR>
DDD: <input type="text" name="DDD" value="11"><BR>
Telefone: <input type="text" name="Telefone" value="38192014"><BR>
<input type="hidden" name="dias_venc" value="5">
<input type="hidden" name="store" value="yes">
<input type="hidden" name="user" value="boletostore"><!--coloque aqui o seu username -->
<input type="hidden" name="action" value="3"><BR>
<input type="submit">
</form>
</body>
</html>
dúvida adicionais: atendimento@boletomail.com.br