Banco do Brasil

Como funciona

  1. Após escolher o produto na loja, o comprador seleciona a forma de pagamento Boleto Registrado Banco do Brasil;
  2. O checkout exibirá a URL do Boleto;
  3. 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:

DadoFormato
URL (site) retorno à lojahttps://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:

CampoValor
Assinatura de AfiliaçãoAppKey
UsernameClientId
SenhaClientSecret

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.