Open Banking Banco do Brasil: Evite interrupções nas integrações de Cobrança com o Banco do Brasil: Revise o Scope das credenciais até 15/09/2026
FAQ_CIGAM > FAQ_Finanças > Gestão Financeira > Open Banking Banco do Brasil: Evite interrupções nas integrações de Cobrança com o Banco do Brasil: Revise o Scope das credenciais até 15/09/2026
Palavras-Chave
Open Banking. Comunicado. Evite Interrupções. API. Cobrança. Cobranças. Boletos. Scope. Requisicao. PIX. 15/09/2026. 15/09/26.
Comunicado Banco do Brasil
O Banco do Brasil comunicou uma alteração no processo de validação do parâmetro Scope utilizado na obtenção de tokens de acesso às suas APIs. A partir de 15/09/2026, o banco passará a validar se os scopes informados na solicitação correspondem efetivamente às APIs e produtos habilitados para a aplicação cadastrada no Portal Developers BB.
Dessa forma, esta FAQ tem como objetivo orientar sobre as adequações que devem ser realizadas no ERP CIGAM, especialmente em relação à configuração do campo Scope nas credenciais de Open Banking, para atender às novas regras de validação estabelecidas pelo Banco do Brasil e evitar possíveis interrupções nas integrações.
Caso as permissões informadas no Scope não estejam devidamente habilitadas para a aplicação utilizada, a solicitação de autenticação poderá ser rejeitada pelo banco, impedindo a utilização de serviços como registro, consulta e manutenção de boletos, geração de PIX e demais operações realizadas por meio das APIs do Banco do Brasil.
Por esse motivo, recomendamos que todos os clientes que utilizam integrações via Open Banking com o Banco do Brasil realizem a conferência e adequação de suas configurações antes de 15/09/2026, evitando impactos operacionais em suas rotinas financeiras.
Importante: Embora a data estipulada pelo banco seja 15/09/2026, recomendamos que todos os clientes que utilizam integrações via Open Banking com o Banco do Brasil realizem a conferência e adequação de suas configurações antes de 15/09/2026, evitando impactos operacionais em suas rotinas financeiras.
Orientações
O Banco do Brasil informou uma alteração na validação do parâmetro Scope utilizado na obtenção do token de acesso às suas APIs.
A partir de 15/09/2026, o Banco do Brasil passará a validar se os scopes solicitados correspondem às APIs para as quais a aplicação possui autorização no Portal Developers BB.
Dessa forma, caso o Scope configurado no CIGAM contenha permissões que não estejam habilitadas para as credenciais utilizadas, a solicitação do token poderá ser rejeitada pelo Banco do Brasil.
O que isso pode causar?
A não adequação do Scope poderá impedir a autenticação do CIGAM junto ao Banco do Brasil e, consequentemente, interromper operações realizadas por meio das APIs, como registro/emissão, alteração e consulta de boletos ou geração de PIX em suas vendas.
Por isso, recomendamos que a configuração seja conferida antes de 15/09/2026. Evite para sua operação.
Para clientes que já utilizam o Open Banking
Acesse no CIGAM:
O programa Configuração de Bancos, através do menu Finanças > Gestão Financeira > Parâmetros.
Certifique-se de estar posicionado no banco 001 – Banco do Brasil na tela de Configuração de Bancos.
Acesse as credenciais através do botão <Open Banking> e verifique o campo Scope, ajustando-o de acordo com as APIs efetivamente habilitadas para as credenciais utilizadas no Portal Developers BB.
Essa verificação deve ser realizada para todos os convênios do Banco do Brasil que possuírem parametrizações de Open Banking no CIGAM.
Demonstração da tela onde o Scope está informado e que pode ser alterado conforme necessidade:
Para clientes que ainda irão parametrizar o Open Banking
Ao realizar a parametrização pelo Assistente de Configuração do Open Banking, informe no campo Scope somente as permissões correspondentes às APIs do Banco do Brasil que serão utilizadas e que estejam habilitadas para a aplicação.
Dessa forma, a configuração já será criada de acordo com as novas regras de validação do Banco do Brasil.
Como saber quais APIs estão habilitadas?
No Portal Developers BB, acesse a aplicação utilizada pelo CIGAM e consulte as APIs/Produtos habilitados para essa aplicação e suas credenciais.
O Scope deve ser montado considerando somente os serviços efetivamente habilitados e utilizados pela integração.
Dúvidas sobre o acesso e consultas dentro do Portal Developers do BB, acione o Gerente de Cash do seu Banco.
Exemplos de Scopes:
| Somente API de Cobrança |
|---|
|
cobrancas.boletos-requisicao cobrancas.boletos-info |
| Somente API de PIX |
|---|
|
pix.read pix.write |
| API de Cobrança + API de PIX |
|---|
|
cobrancas.boletos-requisicao cobrancas.boletos-info cob.write cob.read pix.read pix.write |
Após a alteração, utilize a opção Validar, quando disponível, para verificar a comunicação das credenciais.
Para mais informações sobre a configuração do Open Banking para o Banco do Brasil, consulte a documentação CIGAM:
