Banco do Brasil

Como funciona

Após escolher o produto na loja, o comprador seleciona a forma de pagamento Boleto Registrado Banco do Brasil;
O checkout exibirá a URL do Boleto;
O cliente acessa a URL (renderização) e poderá realizar o pagamento.

⚠️
Atenção

A conciliação de status não está disponível para o Checkout Cielo;

O estabelecimento precisa conciliar manualmente o pagamento do boleto.

Cadastro e configuração com o Banco do Brasil

Ambiente BB

Para habilitar o produto Boleto Registrado, entre em contato com o gerente de relacionamento do Banco do Brasil e forneça as informações abaixo:

Dado	Formato
URL (site) retorno à loja	https://www.pagador.com.br
Formato arquivo Retorno	(X) CBR643
Meio de retorno	(X) Mainframe – para empresa com sistema próprio, que não usam o GFN.

Ao concluir o credenciamento, o estabelecimento receberá um documento.

2. Obter credenciais no portal do Banco do Brasil

Acesse o portal do Banco do Brasil para obter suas credenciais e siga estas etapas:

•  Criar cadastro no portal BB;

•  Criar uma aplicação (API de cobranças);

•  Realizar testes e envio para produção.

3. Cadastrar credencias

Para usar o provedor BancoDoBrasil3, é obrigatório cadastrar as credenciais abaixo com o  suporte Cielo:

Campo	Valor
Assinatura de Afiliação	`AppKey`
Username	`ClientId`
Senha	`ClientSecret`

Configuração do boleto na Cielo

Dados de cadastro

Você deve informar ao  suporte Cielo  os seguintes dados:

Dados	Descrição	Formato	OBS
Agência	Código agência	4 dígitos	Apenas os quatro números da agência são obrigatórios, sem incluir dígito.
Conta	Conta corrente	7 dígitos	Hífen obrigatório.
Carteira	Número da carteira e variação* A carteira determina as características do serviço de cobrança e define como os boletos serão tratados pelo BB.	5 dígitos no formato “XX/XX”	Exemplo: “17/27”.
Convênio	Convênio de comércio eletrônico	6 dígitos	É o mesmo valor de Conciliação (Convênio de cobrança) fornecido pelo banco.
Nosso Número	Número do boleto que permite sua identificação junto ao BB. É um contador incremental.	5 dígitos	Inserir "10000" - A cada emissão de boleto esse numero aumenta em +1.
Vencimento	Prazo de validade do boleto	2 dígitos no formato “XX”	É o valor padrão, se nenhum outro valor for enviado via API.
Instruções	Informações exibidas no boleto	50 dígitos	Somente números e letras de A-Z, não pode haver caracteres especiais ou mais de um espaçamento entre cada palavra.
AppKey	Assinatura de afiliação fornecida pelo Banco do Brasil.  Disponível no portal BB.	32 dígitos	Sequência hexadecimal.
ClientId	Identificador no Banco do Brasil	—	Credencial fornecida pelo Banco do Brasil.
ClientSecret	Chave no Banco do Brasil	—	Credencial fornecida pelo Banco do Brasil.

*Variação da carteira para o Banco do Brasil: parâmetro de agrupamento de boletos dentro de uma mesma carteira, permite que a loja agrupe seus boletos, de acordo com modelos de negócios diferentes (filiais, pontos de venda, etc.).

⚠️
A loja deverá obrigatoriamente enviar no contrato da API os dados (nome do comprador, CPF e endereço completo).

Conciliação de boletos

NO MOMENTO, O BOLETO REGISTRADO BANCO DO BRASIL NÃO REALIZA ATUALIZAÇÃO AUTOMÁTICA DE STATUS.