Soluções em Comércio Eletrônico
Meios de Pagamento na Internet
Manual da Empresa Convenente
Orientações Técnicas
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...
8
2. Formulários...
12
a) Formulário – Pagamento...
12
b) Formulário – Notifica...
13
c) Formulário – Sonda...
14
Retorno da consulta à situação do pagamento...
15
Estrutura XML ...
16
Estrutura “lojavirtual.dtd”...
16
Resposta em forma de String... 16
d) Formulário – Pagamento (segunda via de bloqueto de cobrança)...
17
3. Leiautes...
18
a) Leiaute de arquivo retorno – débito em conta...
18
b) Leiaute de arquivo retorno – cobrança de títulos – CBR643...
20
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:
http://www.bb.com.br/portal/emp/ep/srv/dwn/regulamento.pdf
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.
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.
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.
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:
http://www.lojavirtual.com.br
ou
https://lojavirtual.com.br
).
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
https://www11.bb.com.br/site/mpag/simulador/loja.jsp
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>.
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.
V. Anexos
1. DIAGRAMA DE SEQÜÊNCIA – PAGAMENTOS
1. O comprador (Pessoa Física e/ou Pessoa Jurídica), após concluir todas as fases de compra,
solicita check out do pedido;
2 4 : g e r a i n f o r m a ç ã o : C o m p r a d o r : S i t e L o j a : F e c h a r P e d i d o : S i t e B B : H o s t B B : B a c k O f f i c e L o j a 1 : c h e c k o u t 2 : c h e c k o u t 3 : v a l i d a 4 : c a l c u l a 5 : r e s u m o p e d i d o 6 : m o n t a f o r m u l á r i o 7 : a p r e s e n t a p e d i d o 8 : s u b m e t e f o r m u l á r i o 9 : v a l i d a f o r m u l á r i o 1 0 : s u b m e t e 1 1 : v a l i d a c o n v ê n i o 1 2 : r e c u p e r a a t r i b u t o s 1 3 : a p r e s e n t a o p ç õ e s d e p a g a m e n t o 1 4 : e f e t u a p a g a m e n t o - d é b i t o e m c o n t a 1 5 : s u b m e t e p a g a m e n t o 1 6 : a u t e n t i c a c l i e n t e 1 7 : c o n t a b i l i z a p a g t o 1 8 : p a g a m e n t o e f e t i v a d o 1 9 : r e t o r n a 2 0 : c o n s u l t a s i t u a ç ã o p a g a m e n t o 2 1 : s o l i c i t a c o n s u l t a 2 2 : r e c u p e r a i n f o r m a ç ã o 2 3 : i n f o r m a s i t u a ç ã o p a g a m e n t o 2 5 : e n t r e g a p r o d u t o / s e r v i ç o
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’.
−
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
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;
a) Formulário – Pagamento
Variáveis de Envio do formulário – Pagamento: Comprador à Site do Banco
Enviar para URL: "https://www11.bb.com.br/site/mpag/"
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 10000
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 1000000 (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
Estrutura do formulário - Pagamento
<form action="https://www11.bb.com.br/si 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çãorefTran 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 1000000 (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
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: “
https://www11.bb.com.br/site/mpag/REC3.jsp"
Variáveis
Tam Tipo Utilização DescriçãoidConv 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 1000000 (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 10000
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
Estrutura do formulário - Sonda
<form action=" https://www11.bb.com.br/site/mpag/REC3.jsp" 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çãorefTran 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 1000000 (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 10000
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
008 Num C Data do lançamento contábil do pagamento, no formado DDMMAAAA
Utilização (legenda):
M = mandatório
C = condicional
<!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-8859-1"?> <!ELEMENT FORMULARIO (ENTRADA)+> <!ELEMENT ENTRADA (EMPTY)>
<!ATTLIST ENTRADA nome CDATA #REQUIRED valor CDATA #REQUIRED>
Resposta em forma de String
String = aaaaaaaaaaaaaaaaa000000000000000bbbbbbcddeeeeeeee, onde:
Variáveis
Tam Tipo Descriçãoaaaaaaaaaaaaaaaa 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 1000000 (um milhão) - informe CCCCCCCNNNNNNNNNN, onde:
"C" = número do convênio de cobrança "N" = número livre de controle do Convenente.
000000000000000
(valor)
015 Num Valor do pagamento, com centavos sem formatação. exemplo: R$ 100,00 assume 10000
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)
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
eeeeeeee
(dataPagamento)
008 Num Data do lançamento contábil do pagamento, no formado DDMMAAAA
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: "https://www11.bb.com.br/site/mpag/"
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 10000
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 1000000 (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
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="https://www11.bb.com.br/site/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="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
A1 01-01 X(001) Código do registro assume “A”
A2 02-02 9(001) Código de remessa assume 2 (retorno enviado pelo banco)
A3 03-08 9(006) Número do convênio A4 09-09 X(001) Uso futuro
A5 10-18 9(009) Seqüencial de retorno do IED –Intercâmbio Eletrônico de Dados
A6 19-22 X(005) Uso futuro
A7 23-42 X(020) Nome da empresa / órgão
A8 43-45 9(003) Código do banco na compensação interbancária A9 46-65 X(020) Nome do banco
A10 66-73 9(008) Data da geração do arquivo – formato AAAAMMDD A11 74-79 9(006) Número seqüencial do arquivo
A12 80-81 9(002) Versão do leiaute adotado pela Febraban para registro tipo G
A13 82-142 X(061) Reservado uso futuro
A14 143-150 X(008) No caso do comércio eletrônico, este campo se apresentará vazio.
DETALHE DO ARQUIVO RETORNO – CÓDIGO DE REGISTRO G
Campo Posição Tipo Conteúdo
G1 01-01 X(001) Código do registro assume “G” G2 02-05 9(004) Prefixo da agência creditada
G3 06-06 X(001) Digito verificador do prefixo da agência – módulo 11
G4 07-15 9(009) Número da conta corrente creditada
G5 16-16 X(001) Digito verificador do numero da conta corrente-módulo 11
G6 17-21 X(005) Uso futuro
G7 22-29 9(008) Data do pagamento - formato AAAAMMDD G8 30-37 9(008) Data do credito - formato AAAAMMDD
G9 38-81 X(044) Código de barra – vide especificação abaixo G10 82-93 9(010)v99 Valor recebido
G11 94-100 9(005)v99 Valor da tarifa
G12 101-108 9(008) Número seqüencial de registro G13 109-112 9(004) Prefixo da agencia recebedora G14 113-116 X(004) Uso futuro
G15 117-117 9(001) Forma de arrecadação: 1 - Caixa, 2 - Eletrônica, 3 - Internet
G16 118-140 X(023) Autenticação eletrônica
G17 141-141 9(001) Forma de recebimento: 1- Dinheiro, 2 – Cheque, 3 – Não identificada
G18 142-150 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
G9.1 01-01 9(001) Código identificação do produto - assume 8 (arrecadação)
G9.2 02-02 9(001) Identificação do segmento e a forma de identificação da empresa/órgão – assume: 9 G9.3 03-03 9(001) Identificador do valor real ou referencia –
assume 6 (real)
G9.4 04-04 9(001) Digito verificador geral – modulo 10 G9.5 05-15 9(011) Valor em reais
G9.6 16-19 9(004) Código do Banco no sistema de compensação. Assume: 0001 G9.7 20-21 9(002) Preenchido com o valor ‘01’. G9.8 22-27 9(006) Código do convênio RCB
G9.9 28-44 9(017) Número do pedido (é o valor que foi atribuído a variável refTran gerado pelo conveniado)
Z1 01-01 X(001) Código do registro assume “Z”
Z2 02-07 9(006) Total de registros do arquivo, inclusive header e trailler
Z3 08-24 9(017) Valor total recebido dos registros do arquivo Z4 25-150 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
H1 001-001 9(001) Assume: 0 (zero) H2 002-002 9(001) Assume: 2 (dois) H3 003-009 X(007) Assume: RETORNO H4 010-011 9(002) Assume: 01 H5 012-019 X(008) Assume: COBRANCA H6 020-026 X(007) Uso futuro
H7 027-030 9(004) Prefixo da agência de relacionamento do Convenente
H8 031-031 X(001) Digito verificador do prefixo da agência de relacionamento
H9 032-039 9(008) Código do Cedente
H10 040-040 X(001) Digito verificador do código do Cedente H11 041-046 9(006) Número do Convenente líder
H12 047-076 X(030) Nome da Empresa Convenente H13 077-094 X(018) Assume: 001BANCO DO BRASIL
H14 095-100 9(006) Data da gravação do arquivo no formado DDMMAA H15 101-107 9(007) Número seqüencial de retorno
H16 108-394 X(287) Uso futuro H17 395-400 9(006) Assume: 000001
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
D1 001-001 9(001) Assume: 1 (um) D2 002-003 9(002) Assume: 00 (zeros) D3 004-017 9(014) Assume: 000... (zeros)
D4 018-021 9(004) Prefixo da agência de relacionamento do Convenente
D5 022-022 X(001) Digito verificador do prefixo da agência de relacionamento
D6 023-030 9(008) Código do Cedente
D7 031-031 X(001) Dígito verificador do código do Cedente D8 032-037 9(006) Número do Convênio
D9 038-062 X(025) Campo de controle do participante D10 063-073 9(011) Assume: 000... (zeros)
D12 075-085 X(011) Uso futuro
D13 086-088 9(003) Variação da carteira de cobrança D14 089-106 X(018) Uso Futuro
D15 107-108 9(002) Número da carteira de cobrança
D16 109-110 9(002) Assume: 06=liquidação normal, 07=liquidação por conta, 08=liquidação por saldo, 15=liquidação em cartório
D17 111-116 9(006) Data da liquidação no formato DDMMAA D18 117-152 X(036) Uso futuro
D19 153-165 9(11)V99 Valor do título D20 166-168 9(003) Assume: 001
D21 169-172 9(004) Prefixo da agência recebedora
D22 173-173 X(001) Dígito verificador do prefixo da agência recebedora D23 174-175 9(002) Uso futuro
D24 176-181 9(006) Data do crédito no formato DDMMAA D25 182-188 9(05)V99 Valor da tarifa D26 189-201 9(11)V99 Outras despesas D27 202-227 9(026) Assume: 000...(zeros) D28 228-240 9(11)V99 Valor do abatimento D29 241-253 9(11)V99 Desconto concedido D30 254-266 9(11)V99 Valor recebido D31 267-279 9(11)V99 Juros de mora D32 280-292 9(11)V99 Outros recebimentos D33 293-305 9(11)V99 Assume: 000... (zeros) D34 306-318 9(11)V99 Valor do lançamento
D35 319-319 9(001) Indicativo de débito/crédito, assume: 0=sem lançamento, 1=débito, 2=crédito
D36 320-394 X(075) Uso futuro
D37 395-400 9(006) Número seqüencial de registro
DETAL HE DO CAMPO D9 - Campo de controle do participante
Campo Posição Tipo Conteúdo
D9.1 01-02 9(002) Assume: 21 D9.2 03-08 X(006) Assume: brancos
D9.3 09-25 9(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
T1 001-001 9(001) Assume: 9 (nove) T2 002-002 9(001) Assume: 2 (dois) T3 003-004 9(002) Assume: 01 (um)
T4 005-007 9(003) Número do Banco Assume: 001 T5 008-394 X(386) Filler
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: 09.07.2004
Motivo da atualização: Ajustes redacionais. Atualização número: 009
Data de publicação: 14.06.2004
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: 27.02.2003
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: 29.11.2002
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: 13.11.2002
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: 13.05.2002
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: 13.12.2001
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: 09.04.2001
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: 12.03.2001
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: 15.12.2000
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.