Soluções em Comércio Eletrônico. Manual da Empresa Convenente

Transcrição

1 Soluções em Comércio Eletrônico Meios de Pagamento na Internet Manual da Empresa Convenente Orientações Técnicas Versão /03/2006

2 Índice I. Apresentação Vantagens oferecidas... 3 Requisitos necessários... 3 II. Características Fluxo operacional... 4 Como funciona... 4 Intercâmbio de informações em meio magnético... 4 III. Opções de Meios de Pagamentos Débito em conta... 5 Bloqueto bancário... 5 IV. Roteiro de implantação Formalização de convênios... 6 Implementação do código... 6 Simulações e homologação da implementação... 7 Ativação do convênio... 7 V. Anexos 1. Diagrama de seqüência Pagamentos Formulários a) Formulário Pagamento b) Formulário Notifica c) Formulário Sonda Retorno da consulta à situação do pagamento Estrutura XML Estrutura lojavirtual.dtd Resposta em forma de String d) Formulário Pagamento (segunda via de bloqueto de cobrança) Leiautes a) Leiaute de arquivo retorno débito em conta b) Leiaute de arquivo retorno cobrança de títulos CBR Histórico das atualizações do documento Versão 011 2

3 I. Apresentação O Banco do Brasil desenvolveu a solução para Meios de Pagamento na Internet, especialmente para empresas que atuam em comércio eletrônico. Os Meios de Pagamento na Internet realizam a intermediação financeira entre empresas e consumidores (B2C), entre empresas e empresas (B2B); oferecendo diversas opções de pagamento, possibilitando à empresa escolher as mais adequadas às suas necessidades. Trata-se de um serviço seguro e completo, que permite o acompanhamento da transação em tempo real na modalidade débito em conta e, de todas, no back-office da empresa, utilizando o Gerenciador Financeiro ou seu sistema de gestão. O regulamento do comércio eletrônico do Banco encontra-se disponível para download no endereço: Vantagens oferecidas Simplicidade de implementação; Todo clearing financeiro a cargo do Banco; Confiabilidade e segurança do Banco do Brasil; Menores taxas do mercado; Maior base de clientes usuário de Internet na América Latina; Requisitos necessários A empresa deverá ser cliente do Banco e possuir um cadastro em situação normal, formalizando os convênios específicos para cada meio de pagamento e cumprir roteiro de implantação. Versão 011 3

4 II. Características Fluxo operacional Como funciona A partir do site do Convenente, o comprador(pessoa Física ou Pessoa Jurídica) faz sua opção de pagamento. Nesse momento são apresentadas as opções de pagamento que o site tem negociado com o Banco (caso o site tenha apenas uma forma de pagamento negociada com o Banco, somente esse meio de pagamento será apresentado). Na chamada ao site do Banco ocorre a passagem de parâmetros que identificam a origem e qual a forma de pagamento deve ser oferecidas para a transação que está sendo realizada. A validação do convênio é realizada no ambiente do Banco. Todo o processo de autenticação dos clientes envolvidos na transação, verificação de disponibilidade financeira - para formas de pagamento que exijam essa validação bem como o processamento contábil da operação comercial são realizados com segurança, garantindo a integridade dos dados em todo o ciclo da transação. A atualização na base de dados se dá em tempo real, permitindo a consulta on-line ao status de pagamento (a consulta ao status de pagamento do pedido é feita a partir do site do Banco). O Banco oferece todas as informações relativas às transações financeiras realizadas, no próprio domicílio do cliente, através do Gerenciador Financeiro. Intercâmbio de Informações em meio magnético Diariamente, o Banco disponibiliza as informações de todos os pagamentos realizados no dia anterior, através da geração de arquivo retorno. A empresa receberá o arquivo RCB001, discriminando os pagamentos realizados por débito em conta, seja Pessoa Física ou Pessoa Jurídica. A informação dos pagamentos realizados por bloqueto bancário estará discriminada no arquivo CBR643 ou CNAB240. O Banco disponibiliza diversas formas de acesso/conexão. A empresa deverá, quando da formalização do convênio, fazer opção do tipo de acesso/conexão. Versão 011 4

5 III. Opções de Meios de Pagamentos Débito em conta Forma de pagamento à vista, mediante débito em conta corrente do comprador (Pessoa Física - B2C ou Jurídica B2B) e crédito em conta corrente da empresa. Fluxo da transação: validação do convênio; autenticação do cliente comprador; verificação da disponibilidade de fundos; lançamento do débito em conta corrente do comprador; registro da transação em base de dados. O crédito correspondente à compra/serviço será contabilizado na conta da empresa em D+N, conforme float negociado junto à agência de relacionamento, agrupado em único lançamento. A empresa receberá arquivo RCB001 com a demonstração de todos os pagamentos, bem como poderá iniciar transação de consulta, no site do Banco, para verificação do status de pagamento do pedido de compra/serviço. Para que a empresa tenha acesso a esse meio de pagamento, é necessário: possuir conta corrente; possuir convênio de arrecadação; indicar o tipo de intercâmbio de informações em meio magnético. cumprir roteiro de implantação Bloqueto bancário - Cobrança sem registro Forma de pagamento mediante geração de bloqueto de cobrança bancária impresso pelo próprio comprador (Cobrança sem registro). O crédito correspondente à compra/serviço será contabilizado na conta da empresa quando da liquidação do título. A empresa receberá arquivo CBR643 ou CNAB240 com a demonstração de todos os pagamentos. Para que a empresa tenha acesso a esse meio de pagamento, é necessário: possuir conta corrente; possuir convênio de cobrança; indicar o tipo de intercâmbio de informações em meio magnético. cumprir roteiro de implantação. Versão 011 5

6 IV. Roteiro para Implantação Formalização de convênios Na agência de relacionamento da empresa, deverá ser formalizado: convênio de arrecadação para permitir o pagamento por Débito em Conta para Pessoa Física e Pessoa Jurídica - RCB; convênio de cobrança para pagamento por Bloqueto bancário de acordo com as necessidades do cliente; convênio de comércio eletrônico para permitir a troca eletrônica de parâmetros/ informações dos formulários. Deverá ser informado ao Banco, para uso como meio de pagamento via Internet, os seguintes atributos: Valor limite de compras esse atributo determina o valor máximo permitido para cada pagamento; URL que identificará o site do Convenente. (exemplos: ou ). Solicitar ao gerente responsável pela formalização do(s) convênio(s) o fornecimento do identificador do convênio para uso via Internet (esse será o número atribuído à variável idconv vide código de implementação). O convênio de comércio eletrônico ficará com status 9 - Não Ativo. Essa situação é desejável, pois permitirá a homologação da implementação. Implementação do código A empresa deverá implementar, no ambiente do site, código da estrutura do formulário, para captura das variáveis relativas ao pagamento da compra/serviço. Deverá implementar também, no ambiente de administração do site, o código da estrutura de formulário que permitirá a consulta à situação do pagamento. No endereço pode-se efetuar a simulação de pagamentos, permitindo visualizar solução de implementação. A empresa responsável pela implementação deverá cumprir os seguintes requisitos técnicos: O link para o Banco deverá ser acionado somente após o comprador ter executado todos os passos necessários a sua compra (checkout), faltando apenas efetuar o pagamento; A página que receberá a postagem do formulário não poderá ser aberta em frame. Exemplo: a página não poderá conter a tag html <frameset>. Verifique o detalhamento da implementação nos anexos deste documento. Versão 011 6

7 Simulações e homologação da implementação A equipe técnica da empresa deverá realizar simulações de pagamentos, de forma a garantir o perfeito funcionamento da implementação. Enquanto a situação do convênio for 9 Não Ativo os pagamentos realizados pela opção débito em conta não sensibilizarão as contas envolvidas. O sistema do Banco permitirá o processamento de todo o fluxo indicando, porem, que essa operação é uma simulação sem qualquer efeito contábil. Nesta situação, será apresentado o nome empresa precedido da palavra Teste. A homologação deverá ser realizada em ambiente de produção. Ativação do convênio Após a conclusão da fase de homologação, a empresa deverá comunicar ao Banco que está apta a oferecer os Meios de Pagamentos do Banco. De posse dessa informação, a agência providenciará a ativação do convênio. Deve-se observar que, apenas após a ativação do convênio pela agencia, a empresa poderá disponibilizar os Meios de Pagamentos em seu site. Após a ativação do convênio, a palavra Teste deixará de ser mostrada. A variável reftran deverá ser sequencial, não podendo ser reutilizados os números usados nos testes. Versão 011 7

8 V. Anexos 1. DIAGRAMA DE SEQÜÊNCIA PAGAMENTOS : Comprador : SiteLoja : FecharPedido : SiteBB : HostBB : BackOfficeLoja 1: check out 2: check out 3: valida 5: resumo pedido 4: calcula 7: apresenta pedido 6: monta formulário 8: submete formulário 9: valida formulário 10: submete 11: valida convênio 12: recupera atributos 13: apresenta opções de pagamento 14: efetua pagamento - débito em conta 15: submete pagamento 16: autentica cliente 17: contabiliza pagto 18: pagamento efetivado 19: retorna 20: consulta situação pagamento 23: informa situação pagamento 21: solicita consulta 22: recupera informação 24: gera informação 25: entrega produto/serviço 1. O comprador (Pessoa Física e/ou Pessoa Jurídica), após concluir todas as fases de compra, solicita check out do pedido; Versão 011 8

9 2. A solicitação de check out é encaminha para validação; 3. O pedido de compras é validado; 4. O pedido de compras é calculado e registrado; 5. Atributos do pedido de compras é encaminhado para apresentação; 6. Variáveis do formulário pagamento são montadas; Obs: Verificar item Formulários Pagamento, para maiores detalhes. 7. Pedido de compra é apresentado ao comprador para confirmação; 8. Comprador confirma o pedido e submete formulário montado pela Convenente ao site do Banco; 9. O formulário pagamento é validado: verificado se o conteúdo das variáveis idconv, valor e reftran é numérico e maior que zero; verificado se o conteúdo das variáveis dtvenc e tppagamento é numérico; 10. Submete transação de pagamento; Para pagamentos por Débito em conta, verifica-se se a data do pagamento (variável dtvenc ) informada pelo site é data útil, caso não seja, o Banco automaticamente programa o débito para próximo dia útil. 11. Convênio é validado: verificado se convênio existe; verificado se permite o tipo de pagamento selecionado; verificado se o valor solicitado é menor ou igual ao valor máximo de compra estipulado para o convênio. 12. Recupera os atributos do convênio: nome de fantasia do convênio; url do site da Convenente (cadastrada na formalização do convênio); tipos de convênios que a empresa Convenente possui com o Banco. 13. Apresenta página com os dados para o pagamento: Caso a seleção do tipo de pagamento já tenha ocorrido no item 10, será apresentado o leiaute do bloqueto bancário ou será solicitado que o comprador informe os dados necessários para realizar o débito em conta. Caso contrário, serão apresentados banners com as opções de pagamento por Bloqueto bancário e Débito em conta (desde que a empresa tenha firmado essas modalidades de convênios). O pagamento por Débito em conta inicia com a apresentação da página a seguir, e tem associado ao link Voltar para loja a URL formada com a concatenação do endereço do site da Convenente (informado ao Banco no momento da formalização do convênio) + o conteúdo da variável urlretorno do formulário pagamento. Versão 011 9

10 O pagamento por Débito em conta conclui com a apresentação da página abaixo, e tem associado ao botão Continua a URL da página de retorno da Convenente que irá receber a notificação da conclusão do pagamento do comprador. A URL da página é formada com a concatenação do endereço do site da empresa (informado ao Banco no momento da formalização do convênio) + o conteúdo da variável urlretorno do formulário pagamento. 14. Efetua pagamento por Débito em conta Pessoa Física: A partir desse ponto o fluxo apresentado assume que o pagamento será realizado utilizando a modalidade de Débito em conta. 15. Submete pagamento; 16. Autentica comprador cliente do Banco; 17. Contabiliza o pagamento Versão

11 18. Apresenta página informando autenticação eletrônica do pagamento: Essa página de conclusão do pagamento contém o form notifica, com objetivo de notificar a conclusão do processo de pagamento, desde que o comprador acione o botão Continua disponível na página; a URL associada ao parâmetro action do formulário notifica será montado a partir da URL do site da empresa, cadastrada no Banco quando da formalização do convênio (recuperada no item 12 acima), e complementada com o conteúdo da variável urlretorno do formulário pagamento (submetido pelo comprador no item 8 acima); o formulário notifica será submetido por método post após click no botão Continua disponível na página de conclusão de pagamento. 19. Comprador clica botão Continua ; Na página de retorno da Convenente, recupera-se as variáveis do formulário notifica, possibilitando que a empresa atualize o banco de dados de pedidos de compra; Mesmo que o comprador não clique no botão continua, a operação de débito em conta ou de emissão do bloqueto, está realizada no banco. Para saber se o pagamento foi efetuado, o conventente deve utilizar a opção de Sonda. 20. Consulta situação de pagamento (Sonda); consultar a situação do pagamento é opcional, devendo ser utilizada quando a empresa necessita saber de imediato se o pagamento foi efetivado; a informação sobre a situação do pagamento apenas esta disponível para os pagamentos realizados por Débito em conta corrente; independente de submeter o formulário sonda, diariamente o Banco disponibiliza arquivo com informações dos pagamentos realizados. 21. Solicita consulta; 22. Recupera informação da situação do pagamento; 23. Informa situação do pagamento: o Banco disponibiliza três formatos de apresentação da consulta, em forma de página HTML, em XML e String. 24. Gera diariamente arquivo RCB001 e CBR643 - com os dados relativos aos pagamentos realizados; 25. Efetua a entrega do produto/serviço ao comprador; 26. Cabe à empresa Convenente gerar o comprovante de pagamento. Versão

12 2. FORMULÁRIOS a) Formulário Pagamento Variáveis de Envio do formulário Pagamento: Comprador Site do Banco Enviar para URL: " Variável Tam Tipo Utilização Descrição idconv 006 Num M Código do convênio de Comércio Eletrônico fornecido pelo Banco valor 015 Num M Valor total da compra em reais, com centavos sem formatação. exemplo: R$ 100,00 assume reftran 017 Num M Número atribuído e controlado pelo Convenente, que identifica o pedido de compra em todas as fases do processo de pagamento. A cada nova transação deverá ser gerado outro número reftran, não podendo ser reutilizado. Caso possua convênio de cobrança vinculado ao convênio de Comércio Eletrônico, solicite o número desse convênio para sua agência e verifique: - para convênio de Cobrança com seis posições as 17 posições são livres. - para convênio de Cobrança com sete posições - numeração superior a (um milhão) - informe CCCCCCCNNNNNNNNNN, onde: "C" = número do convênio de cobrança "N" = número livre de controle do Convenente. urlretorno 060 Alfa M Complemento final para montagem da URL de retorno ao site da empresa. Exemplo: /PgtoFinal.asp nome 060 Alfa MC Nome do comprador a ser apresentado no bloqueto de cobrança. endereço 060 Alfa MC Endereço do comprador cidade 018 Alfa MC Cidade do comprador uf 002 Alfa MC Estado cep 008 Num MC CEP dtvenc 008 Num M Data de vencimento do pagamento no formado: DDMMAAAA msgloja 480 Alfa O Instruções do cedente a ser apresentada no bloqueto de cobrança versão 003 Num M Versão da implementação. informar: 002 moeda 003 Num M Código da moeda utilizada no pagamento. informar: 986 Real convclasse 003 Num M Classificação do convênio. Informar: 001 tppagamento 001 M Tipo de pagamento, assume: 0 - Todas as opções 2 - Bloqueto bancário 3 - Débito em conta corrente Utilização (legenda): M = mandatório para qualquer tipo de pagamento MC = mandatório para tipo de pagamento por bloqueto bancário O = opcional Versão

13 Estrutura do formulário - Pagamento <form action=" te/mpag/" method="post" name="pagamento"> <input type="hidden" name="idconv" value="<%= idconv %>"> <input type="hidden" name="valor" value="<%= valor %>"> <input type="hidden" name="reftran" value="<%= reftran %>"> <input type="hidden" name="urlretorno" value="<%= urlretorno %>"> <input type="hidden" name="nome" value="<%= nome %>"> <input type="hidden" name="endereco" value="<%= endereco %>"> <input type="hidden" name="cidade" value="<%= cidade %>"> <input type="hidden" name="uf" value="<%= uf %>"> <input type="hidden" name="cep" value="<%= cep %>"> <input type="hidden" name="dtvenc" value="<%= dtvenc %>"> <input type="hidden" name="msgloja" value="<%= textolivre %>"> <input type="hidden" name="versao" value="002"> <input type="hidden" name="moeda" value="986"> <input type="hidden" name="convclasse " value="001"> <input type="hidden" name="tppagamento" value= " "> </form> b) Formulário - Notifica Variáveis de Envio do formulário Notifica: Site do Banco Site da empresa Convenente. Enviar para URL: página de retorno da Convenente cadastrada no Banco + complemento Variáveis Tam Tipo Utilização Descrição reftran 017 Num M Número atribuído e controlado pelo Convenente, que identifica o pedido de compra em todas as fases do processo de pagamento. A cada nova transação deverá ser gerado outro número reftran, não podendo ser reutilizado. Caso possua convênio de cobrança vinculado ao convênio de Comércio Eletrônico, solicite o número desse convênio para sua agência e verifique: - para convênio de Cobrança com seis posições as 17 posições são livres. - para convênio de Cobrança com sete posições - numeração superior a (um milhão) - informe CCCCCCCNNNNNNNNNN, onde: "C" = número do convênio de cobrança "N" = número livre de controle do Convenente. idconv 006 Num M Código do convênio de Comércio Eletrônico fornecido pelo Banco tppagamento 001 M Informa qual tipo de pagamento utilizado, assume: 2 - Bloqueto bancário 3 - Débito em conta corrente Utilização (legenda): M = mandatório Versão

14 Estrutura do formulário - Notifica <form action="página de retorno da Convenente cadastrada no Banco+complemento*" method="post" name="notifica"> <!-- Retorno de variáveis para Loja --> <input type="hidden" name="reftran" value=""> <input type="hidden" name="idconv" value=""> <input type="hidden" name="tppagamento" value=""> </form> (*) complemento é o conteúdo da variável urlretorno obtida no formulário pagamento c) Formulário - Sonda Variáveis de envio do formulário Sonda: Site da Convenente Site do Banco Observação: a consulta à situação do pagamento esta disponível apenas para os pagamentos realizados por Débito em conta. Enviar para URL: Variáveis Tam Tipo Utilização Descrição idconv 006 Num M Código do convênio de Comércio Eletrônico fornecido pelo Banco reftran 017 Num M Número atribuído e controlado pelo Convenente, que identifica o pedido de compra em todas as fases do processo de pagamento. A cada nova transação deverá ser gerado outro número reftran, não podendo ser reutilizado. Caso possua convênio de cobrança vinculado ao convênio de Comércio Eletrônico, solicite o número desse convênio para sua agência e verifique: - para convênio de Cobrança com seis posições as 17 posições são livres. - para convênio de Cobrança com sete posições - numeração superior a (um milhão) - informe CCCCCCCNNNNNNNNNN, onde: "C" = número do convênio de cobrança "N" = número livre de controle do Convenente. valorsonda 015 Num M Valor da compra em reais, com centavos, sem formatação. Exemplo: R$100,00 assume formato 002 Num M Formato de retorno da apresentação da consulta assume: 01 = HTML retorno visual em página do Banco para controle manual; 02 = XML retorno em tag XML 03 = String retorno em forma de String Utilização (legenda): M = mandatório Versão

15 Estrutura do formulário - Sonda <form action=" method="post" name="sonda"> <input type="hidden" name="idconv" value="<%= idconv %>"> <input type="hidden" name="reftran" value="<%= reftran %>"> <input type="hidden" name="valorsonda" value="<%= valor %>"> <input type="hidden" name="formato" value=""> </form> Retorno da consulta situação do pagamento Variáveis Tam Tipo Utilização Descrição reftran 017 Num M Número atribuído e controlado pelo Convenente, que identifica o pedido de compra em todas as fases do processo de pagamento. A cada nova transação deverá ser gerado outro número reftran, não podendo ser reutilizado. Caso possua convênio de cobrança vinculado ao convênio de Comércio Eletrônico, solicite o número desse convênio para sua agência e verifique: - para convênio de Cobrança com seis posições as 17 posições são livres. - para convênio de Cobrança com sete posições - numeração superior a (um milhão) - informe CCCCCCCNNNNNNNNNN, onde: "C" = número do convênio de cobrança "N" = número livre de controle do Convenente. valor 015 Num C Valor do pagamento, com centavos sem formatação. exemplo: R$ 100,00 assume idconv 006 Num M Código do convênio de Comércio Eletrônico fornecido pelo Banco tppagamento 001 Num M 2 - Bloqueto bancário 3 - Débito em conta corrente situacao 002 Num M Indica situação do pagamento, assume: 00 = pagamento efetuado; 01 = pagamento não autorizado 02 = erro no processamento da consulta 03 = pagamento não localizado 10 = campo idconv inválido ou nulo 11 = valor informado é inválido, nulo ou não confere com o valor registrado. 12 = campo reftran inválido ou nulo 99 = operação cancelada pelo cliente datapagame nto Utilização (legenda): M = mandatório C = condicional 008 Num C Data do lançamento contábil do pagamento, no formado DDMMAAAA Versão

16 Estrutura XML <?xml version='1.0' encoding='iso ' standalone='no'?> <!DOCTYPE lojavirtual SYSTEM "lojavirtual.dtd"> <FORMULARIO> <ENTRADA nome="reftran" valor=""/> <ENTRADA nome="valor" valor=""/> <ENTRADA nome="idconv" valor=""/> <ENTRADA nome="tppagamento" valor=""/> <ENTRADA nome="situacao" valor=""/> <ENTRADA nome="datapagamento" valor=""/> </FORMULARIO> Estrutura lojavirtual.dtd <?xml version="1.0" encoding="iso "?> <!ELEMENT FORMULARIO (ENTRADA)+> <!ELEMENT ENTRADA (EMPTY)> <!ATTLIST ENTRADA nome CDATA #REQUIRED valor CDATA #REQUIRED> Resposta em forma de String String = aaaaaaaaaaaaaaaaa bbbbbbcddeeeeeeee, onde: Variáveis Tam Tipo Descrição aaaaaaaaaaaaaaaa a (reftran) 017 Num Número atribuído e controlado pelo Convenente, que identifica o pedido de compra em todas as fases do processo de pagamento. A cada nova transação deverá ser gerado outro número reftran, não podendo ser reutilizado. Caso possua convênio de cobrança vinculado ao convênio de Comércio Eletrônico, solicite o número desse convênio para sua agência e verifique: - para convênio de Cobrança com seis posições as 17 posições são livres. - para convênio de Cobrança com sete posições - numeração superior a (um milhão) - informe CCCCCCCNNNNNNNNNN, onde: "C" = número do convênio de cobrança "N" = número livre de controle do Convenente (valor) 015 Num Valor do pagamento, com centavos sem formatação. exemplo: R$ 100,00 assume bbbbbb (idconv) 006 Num Código do convênio de Comércio Eletrônico fornecido pelo Banco c (tppagamento) 001 Num 2 = Bloqueto Bancário 3 = Débito em conta corrente dd (situacao) eeeeeeee (datapagamento) 002 Num Indica situação do pagamento, assume: 00 = pagamento efetuado; 01 = pagamento não autorizado 02 = erro no processamento da consulta 03 = pagamento não localizado 99 = operação cancelada pelo cliente 008 Num Data do lançamento contábil do pagamento, no formado DDMMAAAA Versão

17 d) Formulário Pagamento (segunda via de bloqueto de cobrança - opcional) Variáveis de envio do formulário - Pagamento: Comprador --> site do Banco Enviar para URL: " Variáveis Tam Tipo Utilização Descrição idconv 006 Num M Código do convênio de Comércio Eletrônico fornecido pelo Banco valor 015 Num M Valor total da compra em reais, com centavos sem formatação Exemplo: R$ 100,00 assume reftran 017 Num M Número atribuído e controlado pelo Convenente, que identifica o pedido de compra em todas as fases do processo de pagamento. A cada nova transação deverá ser gerado outro número reftran, não podendo ser reutilizado. Caso possua convênio de cobrança vinculado ao convênio de Comércio Eletrônico, solicite o número desse convênio para sua agência e verifique: - para convênio de Cobrança com seis posições as 17 posições são livres. - para convênio de Cobrança com sete posições - numeração superior a (um milhão) - informe CCCCCCCNNNNNNNNNN, onde: "C" = número do convênio de cobrança "N" = número livre de controle do Convenente. urlretorno 060 Alfa M Complemento final para montagem da URL de retorno ao site da Convenente. Exemplo: /PgtoFinal.asp nome 060 Alfa MC Nome do comprador a ser apresentado no bloqueto de cobrança. endereço 060 Alfa MC Endereço do comprador cidade 018 Alfa MC Cidade do comprador uf 002 Alfa MC Estado cep 008 Num MC Cep dtvenc 008 Num M Data de vencimento do pagamento no formato: DDMMAAAA msgloja 480 Alfa O Instruções do cedente a ser apresentada no bloqueto de cobrança versão 003 Num M Versão da implementação. informar: 002 moeda 003 Num M Código da moeda utilizada no pagamento. informar: 986 Real convclasse 003 Num M Classificação do convênio. Informar: 001 tppagamento 001 Num M Tipo de pagamento, assume: 0 - Todas as opções 2 - Bloqueto Bancário 3 - Débito em conta corrente 001 Num MS 1 - indicativo de segunda via de bloqueto bancário Versão

18 Utilização (legenda): M = Mandatório para qualquer tipo de pagamento MC = Mandatório para tipo de pagamento por bloqueto bancário MS = Mandatório somente para tipo de pagamento correspondente a segunda via de bloqueto bancário. Exemplos: - Quando se tratar de : a) emissão de segunda via, informar tppagamento = 21 b) todas as opções, informar tppagamento = 0 c) bloqueto bancário, infomar tppagamento = 2 d) débito em conta corrente, informar tppagamento = 3 O = Opcional Estrutura do formulário - Pagamento (2ª via de bloqueto de cobrança - opcional) <form action=" method="post" name="pagamento"> <input type="hidden" name="idconv" value="<%= idconv %>"> <input type="hidden" name="valor" value="<%= valor %>"> <input type="hidden" name="reftran" value="<%= reftran %>"> <input type="hidden" name="urlretorno" value="<%= urlretorno %>"> <input type="hidden" name="nome" value="<%= nome %>"> <input type="hidden" name="endereco" value="<%= endereco %>"> <input type="hidden" name="cidade" value="<%= cidade %>"> <input type="hidden" name="uf" value="<%= uf %>"> <input type="hidden" name="cep" value="<%= cep %>"> <input type="hidden" name="dtvenc" value="<%= dtvenc %>"> <input type="hidden" name="msgloja" value="<%= textolivre %>"> <input type="hidden" name="versao" value="002"> <input type="hidden" name="moeda" value="986"> <input type="hidden" name="convclasse" value="001"> <input type="hidden" name="tppagamento" value="21"> </form> 3. LEIAUTES a) Leiaute do arquivo de retorno pagamentos (débito em conta) HEADER DO ARQUIVO RETORNO CÓDIGO DE REGISTRO A Campo Posição Tipo Conteúdo A X(001) Código do registro assume A A (001) Código de remessa assume 2 (retorno enviado pelo banco) A (006) Número do convênio A X(001) Uso futuro A (009) Seqüencial de retorno do IED Intercâmbio Eletrônico de Dados A X(005) Uso futuro A X(020) Nome da empresa / órgão A (003) Código do banco na compensação interbancária A X(020) Nome do banco A (008) Data da geração do arquivo formato AAAAMMDD A (006) Número seqüencial do arquivo A (002) Versão do leiaute adotado pela Febraban para registro tipo G A X(061) Reservado uso futuro A X(008) No caso do comércio eletrônico, este campo se apresentará vazio. Versão

19 DETALHE DO ARQUIVO RETORNO CÓDIGO DE REGISTRO G Campo Posição Tipo Conteúdo G X(001) Código do registro assume G G (004) Prefixo da agência creditada G X(001) Digito verificador do prefixo da agência módulo 11 G (009) Número da conta corrente creditada G X(001) Digito verificador do numero da conta correntemódulo 11 G X(005) Uso futuro G (008) Data do pagamento - formato AAAAMMDD G (008) Data do credito - formato AAAAMMDD G X(044) Código de barra vide especificação abaixo G (010)v99 Valor recebido G (005)v99 Valor da tarifa G (008) Número seqüencial de registro G (004) Prefixo da agencia recebedora G X(004) Uso futuro G (001) Forma de arrecadação: 1 - Caixa, 2 - Eletrônica, 3 - Internet G X(023) Autenticação eletrônica G (001) Forma de recebimento: 1- Dinheiro, 2 Cheque, 3 Não identificada G X(009) Uso futuro Tipo (legenda): X = conteúdo alfanumérico 9 = conteúdo numérico DETALHE DO CAMPO G9 - CÓDIGO DE BARRAS Campo Posição Tipo Conteúdo G (001) Código identificação do produto - assume 8 (arrecadação) G (001) Identificação do segmento e a forma de identificação da empresa/órgão assume: 9 G (001) Identificador do valor real ou referencia assume 6 (real) G (001) Digito verificador geral modulo 10 G (011) Valor em reais G (004) Código do Banco no sistema de compensação. Assume: 0001 G (002) Preenchido com o valor 01. G (006) Código do convênio RCB G (017) Número do pedido (é o valor que foi atribuído a variável reftran gerado pelo conveniado) Versão

20 TRAILLER DO ARQUIVO RETORNO CÓDIGO DE REGISTRO Z Campo Posição Tipo Conteúdo Z X(001) Código do registro assume Z Z (006) Total de registros do arquivo, inclusive header e trailler Z (017) Valor total recebido dos registros do arquivo Z X(126) livre Tipo (legenda): X = conteúdo alfanumérico 9 = conteúdo numérico b) Leiaute do arquivo de retorno cobrança de títulos CBR643 HEADER DO ARQUIVO RETORNO CÓDIGO DE REGISTRO Campo Posição Tipo Conteúdo H (001) Assume: 0 (zero) H (001) Assume: 2 (dois) H X(007) Assume: RETORNO H (002) Assume: 01 H X(008) Assume: COBRANCA H X(007) Uso futuro H (004) Prefixo da agência de relacionamento do Convenente H X(001) Digito verificador do prefixo da agência de relacionamento H (008) Código do Cedente H X(001) Digito verificador do código do Cedente H (006) Número do Convenente líder H X(030) Nome da Empresa Convenente H X(018) Assume: 001BANCO DO BRASIL H (006) Data da gravação do arquivo no formado DDMMAA H (007) Número seqüencial de retorno H X(287) Uso futuro H (006) Assume: Tipo (legenda): X = conteúdo alfanumérico 9 = conteúdo numérico DETALHE DO ARQUIVO RETORNO CÓDIGO DE REGISTRO D Campo Posição Tipo Conteúdo D (001) Assume: 1 (um) D (002) Assume: 00 (zeros) D (014) Assume: (zeros) D (004) Prefixo da agência de relacionamento do Convenente D X(001) Digito verificador do prefixo da agência de relacionamento D (008) Código do Cedente D X(001) Dígito verificador do código do Cedente D (006) Número do Convênio D X(025) Campo de controle do participante D (011) Assume: (zeros) D X(001) Assume: 0 (zero) Versão

21 D X(011) Uso futuro D (003) Variação da carteira de cobrança D X(018) Uso Futuro D (002) Número da carteira de cobrança D (002) Assume: 06=liquidação normal, 07=liquidação por conta, 08=liquidação por saldo, 15=liquidação em cartório D (006) Data da liquidação no formato DDMMAA D X(036) Uso futuro D (11)V99 Valor do título D (003) Assume: 001 D (004) Prefixo da agência recebedora D X(001) Dígito verificador do prefixo da agência recebedora D (002) Uso futuro D (006) Data do crédito no formato DDMMAA D (05)V99 Valor da tarifa D (11)V99 Outras despesas D (026) Assume: (zeros) D (11)V99 Valor do abatimento D (11)V99 Desconto concedido D (11)V99 Valor recebido D (11)V99 Juros de mora D (11)V99 Outros recebimentos D (11)V99 Assume: (zeros) D (11)V99 Valor do lançamento D (001) Indicativo de débito/crédito, assume: 0=sem lançamento, 1=débito, 2=crédito D X(075) Uso futuro D (006) Número seqüencial de registro DETALHE DO CAMPO D9 - Campo de controle do participante Campo Posição Tipo Conteúdo D (002) Assume: 21 D X(006) Assume: brancos D (017) Numero do pedido (é o valor que foi atribuído a variável reftran gerado pelo cedente) Tipo (legenda): X = conteúdo alfanumérico 9 = conteúdo numérico TRAILLER DO ARQUIVO RETORNO CÓDIGO DE REGISTRO T Campo Posição Tipo Conteúdo T (001) Assume: 9 (nove) T (001) Assume: 2 (dois) T (002) Assume: 01 (um) T (003) Número do Banco Assume: 001 T X(386) Filler T (006) Número seqüencial do registro Tipo (legenda): X = conteúdo alfanumérico 9 = conteúdo numérico SUPORTE TÉCNICO - CENTRAL DE ATENDIMENTO: Versão

22 4. HISTÓRICO DAS ATUALIZAÇÕES DESTE DOCUMENTO Atualização número: 011 Data de publicação: Motivo da atualização: Alteração do texto de Descrição da variável "reftran" e outros ajustes redacionais Atualização número: 010 Data de publicação: Motivo da atualização: Ajustes redacionais. Atualização número: 009 Data de publicação: Motivo da atualização: Alteração da Descrição da variável "reftran" e outros ajustes redacionais. Atualização número: 008 Data de publicação: Motivo da atualização: Correção na página 19 do detalhe do campo G9 CÓDIGO DE BARRAS Atualização número: 007 Data de publicação: Motivo da atualização: - Inclusão da configuração de 2ª via de bloqueto de cobrança - Alterações redacionais Atualização número: 006 Data de publicação: Motivo da atualização: Alteração do reftran de 12 posições para 17 posições no servidor www11 Atualização número: 005 Data de publicação: Motivo da atualização: Alteração no nome do Manual e inclusão do telefone do Suporte Técnico Atualização número: 004 Data de publicação: Motivo da atualização: Alteração do endereço de envio do formulário de pagamento e da Sonda. Inclusão do débito em conta para Pessoa Jurídica, e novo formato de retorno da sonda. Atualização número: 003 Data de publicação: Motivo da atualização: Permite que o tamanho da variável reftran seja de 17 posições, quando a opção de pagamento for por bloqueto bancário (tppagamento = 2). Somente disponibilizado para transações que apontem para o servidor do www10. Atualização número: 002 Data de publicação: Motivo da atualização: Retorno da sonda consulta situação do pagamento, em formato XML; Alteração na sistemática de montagem na url da página de retorno ao site da Convenente; Alteração do leiaute do bloqueto bancário. Atualização número: 001 Data de publicação: Motivo da atualização: Alteração da URL para postagem do formulário de pagamento e consulta pagamento. Observações: É necessário que a empresa direcione a postagem do formulário para o novo endereço (www10.bancodobrasil.com.br/bbscr/mpag/bbpag.asp) para pagamentos e o endereço (www10.bancodobrasil.com.br/bbscr/mpag/sondaloj.asp) para consultas a pagamentos. Versão