Guia de Integrao para Boleto Bancrio (sem retorno de gerao)

________________________________________________________________________________

ndice
Captulo 1 ...................................................................................................... 3 Introduo .................................................................................................. 3 Captulo 2 ...................................................................................................... 4 Links de Pagamento ..................................................................................... 4 Captulo 3 ...................................................................................................... 5 Configurando o Gerenciador de Compras ........................................................ 5 Captulo 4 ...................................................................................................... 8 Fluxo de Mensagens Boleto Bancrio sem retorno....................................... 8 Captulo 5 .................................................................................................... 14 Demonstrao de compra Boleto Bancrio .................................................. 14 Captulo 6 .................................................................................................... 15 Atualizao e status dos Boletos gerados ...................................................... 15 Captulo 7 .................................................................................................... 16 Dvidas e Homologao.............................................................................. 16

________________________________________________________________________ 2 de 16

Captulo 1
Introduo
As formas de pagamento do Comrcio Eletrnico Bradesco, devem ser integradas por um desenvolvedor / lojista com conhecimentos em desenvolvimento de sistemas. Neste guia esto contidas: Informaes para configurar o gerenciador; Orientaes para o desenvolvimento das pginas necessrias para o funcionamento do sistema; Contatos para o suporte (telefone e email); Orientaes para a solicitao de homologao do site (obrigatria para a liberao da forma de pagamento).

IMPORTANTE: Informamos que somente so homologadas as formas de pagamentos geradas pelo sistema do Comrcio Eletrnico Bradesco. O Sistema Comrcio Eletrnico compatvel a qualquer linguagem / plataforma.

________________________________________________________________________ 3 de 16

Captulo 2
Links de Pagamento
O processo de integrao da loja com servidor de Boletos Bancrios simples, no entanto deve ser feita com muito cuidado para que os parmetros sejam passados corretamente e erros no sejam criados no processo de pagamento. Assim como no Pagamento Fcil, os dados para o pagamento com Boleto Bancrio so passados para o servidor atravs da resposta fornecida pela pgina DadosCompra.asp (loja de exemplo) ou equivalente. Para dar incio ao processo de integrao, o desenvolvedor da loja dever inserir o seguinte link na pgina de seleo de pagamento da loja (metodo_pagto.asp loja de exemplo):

Ambiente de testes: http://mupteste.comercioeletronico.com.br/sepsBoleto/xxxx/prepara_pagto.asp?merchantid=xxxx&orde rid=zzzz Ambiente de Produo: https://mup.comercioeletronico.com.br/sepsBoleto/xxxx/prepara_pagto.asp?merchantid=xxxx&orderid= zzzz Onde: xxxx dever ser substitudo pelo nmero da loja e zzzz dever ser substitudo pelo nmero do pedido.

IMPORTANTE: Caso a loja esteja utilizando variveis de sesso ou cookies, esses dados sero perdidos no momento em que o comprador clicar neste link de pagamento. A loja poder passar parmetros extras no link de pagamento, pois os mesmos sero devolvidos em todos os acessos que o servidor SPS realizar nas pginas da loja.

________________________________________________________________________ 4 de 16

Captulo 3
Configurando o Gerenciador de Compras
Para acessar o gerenciador de compras da loja, entre com a seguinte URL: http://mupteste.comercioeletronico.com.br/sepsManager/senha.asp?loja=xxxx Onde xxxx o nmero da sua loja. Para efetuar o login, use o Manager e a Senha enviados por email. Aps o login ser apresentada a seguinte tela:

________________________________________________________________________ 5 de 16

Os campos que devero ser preenchidos para a opo de pagamento Boleto Bancrio so: 1) Endereo IP da loja: O endereo de IP do servidor que est hospedando a loja (este campo apenas cadastral). 2) Pgina de falha no pagamento: Esta a URL que ser chamada caso o processo de compra no seja bem-sucedido. Deve ser preenchido com endereo completo e seus diretrios. (Loja de exemplo Falha.asp). 3) URL de notificao p/ Boleto Bancrio Bradesco: Esta a pgina mais importante do processo de integrao da loja com o Sistema de Pagamento Seguro. Neste campo, o desenvolvedor dever preencher com a URL da pgina da loja que vai passar os dados da compra para o Servidor SPS. Esta configurao muito importante. Deve ser preenchido com endereo completo e seus diretrios. (Loja de exemplo - DadosCompra.asp). 4) Post a ser enviado para a loja na notificao: Estes so os parmetros enviados para a pgina de notificao no processo de pagamento que deve ser copiado e colado no campo Post a ser enviado para a loja na notificao dentro do gerenciador de configurao Bradesco no menu Configurao Bradesco. numOrder=[%lid_m%]&merchantid=[%merchantid%]&cod=[%errorcod%]&cctype=[%cctype%]&ccna me=[%ccname%]&ccemail=[%ccemail%]&numparc=[%numparc%]&valparc=[%valparc%]&valtotal=[ %valtotal%]&prazo=[%prazo%]&tipopagto=[%tipopagto%]&assinatura=[%assinatura%]& IMPORTANTE: Caso haja a necessidade de envio de mais parmetros, estes devem ser passados na URL (link de pagamento) no momento em que realizada a chamada para a pgina prepara_pagto.asp. 5) Post a ser enviado para a loja na falha da autorizao: Estes so os parmetros enviados para a pgina de falha no processo de pagamento que deve ser copiado e colado no campo Post a ser enviado para a loja na falha da autorizao dentro do gerenciador de configurao Bradesco no menu Configurao Bradesco. numOrder=[%lid_m%]&merchantid=[%merchantid%]&cod=[%errorcod%]&errordesc=[%errordesc%] & 6) Habilita "frase" do boleto: Habilitar ou no a frase "Caixa: no receber aps a data de vencimento" no boleto. 7) Habilita "Referncia" do boleto: Habilitar ou no o texto Compras efetuadas atravs do Comrcio Eletrnico no boleto. 8) URL de entrada na loja: Neste campo o desenvolvedor da loja dever cadastrar o endereo de entrada da loja, ou seja, a URL do site Para inserir as alteraes clique no boto efetivar.

________________________________________________________________________ 6 de 16

NOTA: Os campos Instrues p/ Boleto (Linhas 1, 2, 3 at 12) no so de preenchimento obrigatrio. Estes podero ser preenchidos com instrues fixas dentro do gerenciador, ou seja, as instrues que estiverem preenchidas nestes campos sero apresentadas para todos os Boletos, sem alterao. Para configurar instrues variveis deve verificar o item 29 INSTRUCAO logo abaixo, lembrando que as instrues so de responsabilidade do Lojista: A imagem a seguir mostra um Boleto gerado com as instrues, bem como o campo Referncia.

________________________________________________________________________ 7 de 16

Captulo 4
Fluxo de Mensagens Boleto Bancrio sem retorno
A figura a seguir mostra o fluxo de dados do pagamento com Boleto Bancrio.

1) Navegao na loja: O cliente navega na loja normalmente, incluindo e retirando produtos na cesta de compras. Quando o cliente finalizar o processo de escolha, a loja apresenta as formas de pagamento disponveis para o cliente. 2) Pagar com Boleto Bancrio: Nesse momento, o cliente escolhe pagar com Boleto Bancrio e redireciona o browser para o servidor de pagamentos link de pagamento passando como parmetros o merchantid (nmero da loja) e o orderid (nmero do pedido). 3) Pede dados da Compra: Ao receber a requisio de compra, o servidor SPS solicita loja (URL de Notificao para Boleto Bancrio Bradesco) os dados da compra, passando como parmetros tudo o que a loja enviou na requisio, mais os parmetros merchantid (nmero de loja), numOrder (nmero do pedido) e o parmetro TransId que ser enviado com o valor getBoleto. 4) Responde dados da Compra: Neste caso, a loja dever montar um Order Description que dever comear com <BEGIN_ORDER_DESCRIPTION> e ser seguido dos seguintes campos:

________________________________________________________________________ 8 de 16

1) orderid: Nmero do pedido usado pela loja. Pode possuir at 27 caracteres alfanumricos, dependendo de como a loja fez a implementao. 2) 3) descritivo: Descrio bsica do produto comprado. quantidade: Quantidade do mesmo produto comprado.

4) unidade: unidade de medida do produto. Ex.: CX para caixa, PC para pacote, UN para unidade e etc. 5) valor: Valor do produto comprado. Este valor dever ser preenchido sem nenhum identificador de moeda nem separadores (vrgula e pontos), ou seja, em centavos. Ex.: Compra de R$23,56 o valor dever estar como 2356. IMPORTANTE: A pgina da loja dever multiplicar o valor unitrio do produto pela quantidade escolhida pelo comprador e o valor total (por produto) dever ser informado na TAG valor, pois o sistema no multiplica. 6) adicional: Nome da taxa que a loja poder cobrar alm do valor da compra. Ex.: Frete, Envio e etc. 7) valorAdicional: Valor cobrado para o adicional. Este valor tambm dever ser preenchido sem nenhum identificador de moeda nem separadores (vrgula e pontos), ou seja, em centavos. IMPORTANTE: Nenhuma TAG poder ter o valor em branco ou nulo. Caso a loja no queira cobrar nenhuma taxa, as TAGs adicional e valorAdicional devero ser retiradas do cdigo. As demais TAGs so obrigatrias. Neste ponto dever finalizar o Order Description com <END_ORDER_DESCRIPTION> e iniciar o Boleto Description com <BEGIN_BOLETO_DESCRIPTION> e ser seguido dos seguintes campos: 8) CEDENTE: o nome da loja que est emitindo o boleto. Por exemplo, Scopus Tecnologia LTDA. 9) BANCO: Este campo deve ser preenchido com o nmero do banco. Neste caso, o valor pode ser constante e igual a 237, que o nmero do banco Bradesco. 10) NUMEROAGENCIA: Este campo deve ser preenchido com o nmero da agncia da conta do lojista. Para o ambiente de testes, o desenvolvedor deve utilizar a agncia de teste 0001. Note que os zeros esquerda so obrigatrios, pois a mesma deve conter 4 dgitos. 11) NUMEROCONTA: Nmero da conta do lojista na agncia informada no item anterior. Para o ambiente de testes, o desenvolvedor deve utilizar a conta de teste 1234567. Note que os zeros esquerda so obrigatrios, pois a mesma deve conter 7 dgitos. 12) ASSINATURA: Este campo dever ser preenchido com a assinatura digital do Boleto sem retorno, que ser fornecida para o lojista. Trata-se de um campo de 256 caracteres hexadecimais. Para o ambiente de testes, o desenvolvedor deve utilizar a assinatura digital abaixo gerada com base na agncia e conta de teste: 233542AD8CA027BA56B63C2E5A530029F68AACD5E152234BFA1446836220CAA53 BD3EA92B296CA94A313E4E438AD64C1E4CF2CBAD6C67DAA00DE7AC2C907A99979 A5AB53BFEF1FD6DD3D3A24B278536929F7F747907F7F922C6C0F3553F8C6E29D68 E1F6E0CA2566C46C63A2DD65AFF7DF4802FBF4811CA58619B33989B8DDF8 IMPORTANTE: Esta assinatura digital (de teste) especfica para esta forma de pagamento, no sendo permitida a utilizao da mesma na opo de pagamento Transferncia entre Contas Bradesco. Vale informar que, a assinatura digital gerada para cada loja pelo Bradesco (assinatura de Produo) tambm diferente da assinatura digital gerado para a opo de pagamento Transferncia entre Contas Bradesco.

________________________________________________________________________ 9 de 16

Esta assinatura pode ser copiada diretamente para o campo de assinatura do Boleto Description. Note que no devero constar quebras de linha na assinatura, ou seja, todos os 256 caracteres devero estar em uma nica linha. 13) DATAEMISSAO: a data de emisso do boleto, que pode ser preenchida com a data local da hora da gerao do boleto. A data precisa estar formatada da seguinte forma: dd/mm/aaaa, no qual dd o dia formatado com zero esquerda, caso o dia seja menor que 10. mm o ms, formatado com zero esquerda, caso o ms seja menor do que 10, e aaaa o ano formatado com 4 algarismos. Exemplos de data 01/01/2011, 23/12/2011, 15/06/2011 etc. 14) DATAPROCESSAMENTO: Esta data em que o boleto gerado. Como o boleto gerado instantaneamente, este campo deve ser preenchido com o mesmo valor do item 12 acima. A data precisa estar formatada da seguinte forma: dd/mm/aaaa, no qual dd o dia formatado com zero esquerda, caso o dia seja menor que 10. mm o ms, formatado com zero esquerda, caso o ms seja menor do que 10, e aaaa o ano formatado com 4 algarismos. Exemplos de data 01/01/2011, 23/12/2011, 15/06/2011 etc. 15) DATAVENCIMENTO: a data de vencimento do boleto. A data precisa estar formatada da seguinte forma: dd/mm/aaaa, onde dd o dia formatado com zero esquerda, caso o dia seja menor que 10, mm o ms, formatado com zero esquerda, caso o ms seja menor do que 10, e aaaa o ano formatado com 4 algarismos. Exemplos de data 01/10/2011, 23/02/2011, 15/06/2011 etc. 16) NOMESACADO: Este campo deve ser preenchido com o nome do comprador que est efetuando a transao. Lembrando que o nome no pode conter parnteses. 17) ENDERECOSACADO: Este campo deve ser preenchido com o endereo do cliente que estiver efetuando a compra. Neste campo no pode conter parnteses. 18) CIDADESACADO: Este campo deve ser preenchido com o nome da cidade do cliente comprador. Neste campo no pode conter parnteses. 19) UFSACADO: Este campo deve ser preenchido com a unidade de federao do endereo do cliente comprador. A unidade de federao deve estar formatada com apenas duas letras. Por exemplo, SP, GO, RN etc. 20) CEPSACADO: Este campo deve ser preenchido com o CEP do logradouro do cliente comprador. No deve conter separadores. Por exemplo, para o CEP 56289-561, deve-se colocar: 56289561 21) CPFSACADO: Este campo deve ser preenchido com o CPF ou CNPJ valido do cliente comprador. O campo deve estar formatado para no conter caracteres separadores. Por exemplo, para o CPF 111.111.11111, deve formatar para 11111111111 (11 dgitos) e para CNPJ 11.111.111/0001-11, deve formatar para 11111111000111 (14 dgitos). 22) NUMEROPEDIDO: Este campo deve ser preenchido pelo nmero do boleto. Recomenda-se o uso do mesmo nmero do pedido da compra, ou orderid, desde que este esteja limitado a 9 caracteres numricos, pois este campo deve conter no mximo 9 dgitos. No h a necessidade de formatao do campo. Assim recomenda-se que a loja faa a emisso dos boletos de forma seqencial, para facilitar o controle da mesma. No ser permitida a emisso de dois boletos com o mesmo nmero e valores diferentes de compra.

________________________________________________________________________ 10 de 16

23) VALORDOCUMENTOFORMATADO: Este campo dever ser preenchido pelo valor da compra. Este valor dever ser formatado com smbolo de moeda (R$) e pontos para separar os milhares e vrgulas para separar os centavos. Por exemplo: uma compra no valor de 1200 reais dever ser formatada para que seja enviado no seguinte formato: R$1.200,00. Note que a representao dos valores diferente da representao usada no Order Description, que obriga a emisso dos valores em centavos. Dentro do arquivo I_String_Functions.asp existe uma funo de exemplo que formata os valores em centavos para o formato esperado pelo servidor de boletos. 24) SHOPPINGID: Este campo dever ser preenchido com o nmero do portal de origem da compra. Se a loja for participante do portal de compras ShopFcil, preencha o campo com o valor 1 (um, sem zeros esquerda). Caso contrrio, preencha este campo com o valor 0 (zero). 25) NUMDOC: Este campo opcional. Caso o lojista queira que o campo Nmero do Documento do Boleto seja preenchido com algum valor. Normalmente preenchido com o mesmo do nmero do pedido desde que este esteja limitado a 9 caracteres numricos, pois este campo deve conter no mximo 9 dgitos. Se a TAG for omitida, o campo correspondente no boleto ficar em branco. 26) CARTEIRA: Este campo opcional. Caso o lojista use um nmero de carteira de cobrana diferente da default que igual a 25. Muita ateno no uso deste campo, pois se um nmero de carteira de cobrana diferente da qual o lojista tem contrato for informado aqui, o recebimento do valor vendido pela loja poder no ser recebido. Recomenda-se o uso apenas por aqueles que tiverem carteira de cobrana especial. Caso contrrio, esta TAG dever ser eliminada da mensagem. Se a TAG for omitida, o campo ser preenchido automaticamente com o valor 25 (default). 27) ANONOSSONUMERO: Este parmetro opcional. Caso seja necessria a alterao do ano do campo Nosso Nmero. Este campo somente dever ser usado pelo lojista que j tiver negociado com o banco a alterao dessa informao. Caso contrrio, a TAG dever ser eliminada da mensagem. Se a TAG for omitida, o campo ser preenchido automaticamente com o valor 97 (default). 28) CIP: Este campo opcional. Indica a regra a ser usada no pagamento de boletos com cheque. muito importante ressaltar que o valor default 865 e somente dever ser alterado mediante negociao com o banco. A alterao deste dado sem prvia negociao pode provocar o no recebimento de boletos pagos com cheque. Se a regra default for usada, esta TAG dever ser eliminada da mensagem. Se a TAG for omitida, o campo ser preenchido automaticamente com o valor 865 (default). 29) INSTRUCAO: Este campo opcional. So as instrues variveis que sero apresentadas no corpo do Boleto, ao total de doze linhas, sendo que cada uma delas tem uma posio especfica no corpo do Boleto. Cada linha de instruo limitada a 60 caracteres alfanumricos, e pode conter caracteres especiais. Ex: -, %, &, $. Obs.: Se na string gerada na pgina de notificao, for apresentada ao menos uma destas doze TAGs de instruo, o contedo das instrues informadas no painel do gerenciador sero ignoradas, pois pelo gerenciador possvel deixar as doze linhas de instrues fixas. Neste ponto dever finalizar o Boleto Description com <END_BOLETO_DESCRIPTION>.

________________________________________________________________________ 11 de 16

A loja de exemplo disponvel para download j contempla o pagamento com Boleto Bancrio. Nesta loja de exemplo, a pgina responsvel pelo envio dos dados para o servidor SPS : DadosCompra.asp. Esta pgina usa algumas funes de formatao de dados que podem ser usadas como exemplo pelos desenvolvedores. Vale lembrar que no so permitidos nmeros repetidos para diferentes compras. O desenvolvedor deve garantir a unicidade dos nmeros destinados ao pagamento com Boleto Bancrio.

ATENO A sintaxe dos campos deve ser respeitada para a correta gerao dos dados para o pagamento com Boleto Bancrio. Veja, a seguir, um exemplo da string gerada pela pgina da loja (exemplo DadosCompra.asp): <BEGIN_ORDER_DESCRIPTION> <orderid>=(2000081719441874301278) <descritivo>=(diskette 3 1/4 Sony) <quantidade>=(1) <unidade>=(cx) <valor>=(700) <descritivo>=(lapiseira Pentel 0.5 preta) <quantidade>=(1) <unidade>=(pc) <valor>=(750) <adicional>=(frete) <valorAdicional>=(400) <adicional>=(manuseio) <valorAdicional>=(1200) <END_ORDER_DESCRIPTION> <BEGIN_BOLETO_DESCRIPTION> <CEDENTE>=(Scopus) <BANCO>=(237) <NUMEROAGENCIA>=(0001) <NUMEROCONTA>=(1234567) <ASSINATURA>=(233542AD8CA027BA56B63C2E5A530029F68AACD5E152234BFA144 6836220CAA53BD3EA92B296CA94A313E4E438AD64C1E4CF2CBAD6C67DAA00DE7AC 2C907A99979A5AB53BFEF1FD6DD3D3A24B278536929F7F747907F7F922C6C0F3553F 8C6E29D68E1F6E0CA2566C46C63A2DD65AFF7DF4802FBF4811CA58619B33989B8DD F8) <DATAEMISSAO>=(17/01/2011) <DATAPROCESSAMENTO>=(17/01/2011) <DATAVENCIMENTO>=(20/01/2011) <NOMESACADO>=(NOME DO SACADO) <ENDERECOSACADO>=(ENDERECO DO SACADO) <CIDADESACADO>=(CIDADE DO SACADO) <UFSACADO>=(SP) <CEPSACADO>=(12345678) <CPFSACADO>=(11111111111) <NUMEROPEDIDO>=(874301278) <VALORDOCUMENTOFORMATADO>=(R$30,50) <SHOPPINGID>=(1) <NUMDOC>=(874301278) <CARTEIRA>=(25) <ANONOSSONUMERO>=(97) <CIP>=(865) <INSTRUCAO1>=(Linha de instruo 1) <INSTRUCAO2>=(Linha de instruo 2) <INSTRUCAO3>=(Linha de instruo 3) <INSTRUCAO4>=(Linha de instruo 4) <INSTRUCAO5>=(Linha de instruo 5)

________________________________________________________________________ 12 de 16

<INSTRUCAO6>=(Linha de instruo 6) <INSTRUCAO7>=(Linha de instruo 7) <INSTRUCAO8>=(Linha de instruo 8) <INSTRUCAO9>=(Linha de instruo 9) <INSTRUCAO10>=(Linha de instruo 10) <INSTRUCAO11>=(Linha de instruo 11) <INSTRUCAO12>=(Linha de instruo 12) <END_BOLETO_DESCRIPTION> 5) Gerao do Boleto Bancrio: Se todos os dados estiverem corretos, o servidor gera um boleto de cobrana e envia ao Browser do cliente. Caso seja necessria a regerao de algum boleto, que por ventura tenha ocorrido erro, a loja dever disponibilizar uma URL para que o boleto seja gerado novamente. Neste caso, a URL dever seguir os mesmos padres da URL de gerao. Salientamos que a loja dever preencher os campos com os dados idnticos aos da primeira gerao. O nico campo que poder ter seu valor alterado o campo referente Data de Vencimento. A aplicao da loja que deve fazer o controle de deciso para a re-impresso do boleto. Para isto, basta verificar, atravs do nmero do pedido, se j foi feita pelo menos uma tentativa de gerao do Boleto Bancrio.

________________________________________________________________________ 13 de 16

Captulo 5
Demonstrao de compra Boleto Bancrio

________________________________________________________________________ 14 de 16

Captulo 6
Atualizao e status dos Boletos gerados
O Comrcio Eletrnico Bradesco, possui atualizao automtica dos pedidos gerados para forma de pagamento Boleto Bancrio, a atualizao realizada uma vez por dia de segunda a sexta. Abaixo esto os status dos pedidos que podero ser apresentados no gerenciador. Boleto - Pendente (10) Este status indica que o boleto foi gerado pelo sistema. Boleto - Pago Manual (11) Este status poder ser modificado manualmente. Ex. Caso um boleto bancrio seja pago e no tenha seu status atualizado automaticamente pelo sistema, o lojista poder, manualmente, trocar o status do documento para que o mesmo conste como Pago. Boleto - Cancelado (12) Este status atualizado manualmente. Ex: Boleto com data de vencimento expirado, desistncia da compra pelo cliente entre outros Boleto - Pago Valor Igual (21) Este status atualizado automaticamente e indica que o Boleto foi pago com um valor IGUAL do que foi gerado. Boleto - Pago Valor a Menor (22) Este status atualizado automaticamente e indica que o Boleto foi pago com um valor MENOR do que foi gerado. Boleto - Pago Valor a Maior (23) Este status atualizado automaticamente e indica que o Boleto foi pago com um valor MAIOR do que foi gerado.

________________________________________________________________________ 15 de 16

Captulo 7
Dvidas e Homologao
Dvidas Surgindo dvidas durante o processo de integrao, o contato poder ser realizado: Atravs do email: kit@scopus.com.br, contendo as seguintes informaes: Nome da loja; CNPJ da loja; Dvida.

Telefones: (11) 3909-3482 (11) 3909-3637

Homologao A homologao dever ser solicitada a equipe do Comrcio Eletrnico. Atravs do email: homologacao@scopus.com.br, contendo as seguintes informaes: Nome da loja; CNPJ da loja; URL do site para teste; Informar qual opo de pagamento que dever ser homologada.

________________________________________________________________________ 16 de 16