Banco do Brasil

ℹ️
Vá para a Referência da API para acessar os exemplos completos de requisição e resposta.

Como funciona

O comprador, após escolher o produto na loja, seleciona a forma de pagamento Boleto Registrado Banco do Brasil.
A loja envia para a Cielo uma requisição chamando o meio de pagamento correspondente.
A Cielo retornará uma URL contendo a imagem do Boleto.

Configurando o boleto

Ambiente BB

O lojista deverá contatar o gerente de relacionamento do Banco do Brasil para solicitar a habilitação do produto Boleto Registrado.
O formulário a seguir deve ser preenchido e entregue ao gerente.

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 final do credenciamento, o lojista receberá um documento.

Ambiente Cielo

Dados de cadastro

O Lojista precisará 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".
Conciliação	Número do convênio de cobrança	7 Dígitos	Inserir o Convênio de cobrança fornecido pelo banco. É o mesmo valor do convênio de comércio eletrônico.
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	6 Dígitos	É 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
ClientId	Identificador no Banco do Brasil	-	Credencial obtida com o Banco do Brasil.
ClientSecret	Chave no Banco do Brasil	-	Credencial obtida com o 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.).

OBS: 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 DE STATUS AUTOMÁTICA