---
title: Banco do Brasil
slug: banco-do-brasil
docTags: 
createdAt: 2025-07-08T17:54:19.524Z
---

# Objetivo

Este conector permite integrar a API Pix do Banco do Brasil à plataforma Fluid. Com ele, é possível consultar, criar, atualizar e cancelar cobranças imediatas ou com vencimento, configurar Webhook Pix e realizar transferências Pix.

## Criando um fluxo

1. Acesse a aba **Meus Fluxos** e clique em **Criar Fluxo**.
2. Dê um nome ao fluxo e clique em **Criar**.
3. Na etapa de **Ação**, selecione o conector **Banco do Brasil**.

## Criando conexão

Para autenticar a integração com o Banco do Brasil, informe:

- **ID do Cliente** *(obrigatório)*: identificador único no OAuth do BB.
- **Chave Secreta do Cliente** *(obrigatório)*: conhecido apenas pela aplicação e o BB.
- **Escopos** *(obrigatório)*: separados por vírgula, conforme escopos registrados na aplicação.

## Configurando fluxo

Escolha o módulo/serviço disponível:

- **Cobrança Pix com a geração de QR Code Dinâmico**

Dentro do módulo, selecione o recurso desejado:

### Recurso: Gerenciamento de cobrança imediata

Operação: Consultar lista de cobranças imediatas

Permite consultar cobranças Pix criadas em um intervalo de tempo.

**Campos obrigatórios:**

- **App Key**
- **Inicio**
- **Fim**

**Campos opcionais:**

- **CPF**, **CNPJ**, **Localização Presente**, **Status**, **Página**, **Registro por página**

**Operação**: Consultar uma cobrança imediata

Consulta os dados de uma cobrança com base no ID.

**Campos obrigatórios:**

- **App Key**
- **ID**

**Campos opcionais:**

- **Revisão**

**Operação**: Criar cobrança imediata - txID definido pelo BB

Cria cobrança com ID gerado automaticamente.

**Campos obrigatórios:**

- **App Key**
- **Corpo da requisição**

**Operação**: Criar cobrança imediata - txID definido pelo usuário recebedor

Cria cobrança com ID definido pelo integrador.

**Campos obrigatórios:**

- **App Key**
- **ID**
- **Corpo da requisição**

**Operação**: Alterar ou cancelar uma cobrança imediata

Permite atualizar ou cancelar uma cobrança existente.

**Campos obrigatórios:**

- **App Key**
- **ID**
- **Corpo da requisição**

### Recurso: Gerenciamento de cobrança com vencimento

**Operação**: Consultar lista de cobranças com vencimento

Consulta todas as cobranças com vencimento em um período.

**Campos obrigatórios:**

- **App Key**
- **Inicio**
- **Fim**

**Campos opcionais:**

- **CPF**, **CNPJ**, **Localização Presente**, **Status**, **Página**, **Registro por página**

**Operação**: Consultar cobrança com vencimento

Busca os dados de uma cobrança específica.

**Campos obrigatórios:**

- **App Key**
- **ID**

**Campos opcionais:**

- **Revisão**

**Operação**: Criar cobrança com vencimento - txID definido pelo usuário recebedor

Cria nova cobrança com vencimento informando o ID.

**Campos obrigatórios:**

- **App Key**
- **ID**
- **Corpo da requisição**

**Operação**: Alterar ou cancelar uma cobrança com vencimento

Atualiza ou cancela uma cobrança com vencimento previamente criada.

**Campos obrigatórios:**

- **App Key**
- **ID**
- **Corpo da requisição**

### Recurso: Gerenciamento de Webhook

**Operação**: Configurar o Webhook Pix

Permite configurar a URL que receberá notificações Pix.

**Campos obrigatórios:**

- **App Key**
- **Chave Pix**
- **Corpo da requisição**

### Recurso: Transferências Pix

**Operação**: Solicitação de transferências PIX

Inicia uma transferência Pix a partir da conta vinculada.

**Campos obrigatórios:**

- **App Key**
- **Chave Pix**
- **Corpo da requisição**

## Observações adicionais

- O corpo da requisição pode ser preenchido via **De/Para** ou **Template**.

## Conclusão

O conector Banco do Brasil oferece ampla cobertura das funcionalidades Pix. Ideal para empresas que buscam automação de cobranças, transferências e notificações via Pix com segurança e controle centralizado na Fluid.