Banco do Brasil
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
- Acesse a aba Meus Fluxos e clique em Criar Fluxo.
- Dê um nome ao fluxo e clique em Criar.
- 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.