Pix Banco do Brasil

O Fácil123 emite PIX com vencimento pelo Banco do Brasil usando a API Pix Cobranças do banco. Configurada a integração, cada cobrança PIX criada em uma venda ou em um lançamento financeiro é registrada no BB e, quando paga, tem o recebimento baixado automaticamente — sem precisar lançar nada no internet banking.

A integração com PIX requer uma aplicação separada no Portal Developers BB, com permissões próprias e um certificado digital. Mesmo que você já tenha feito a integração com boleto, será necessário criar uma nova aplicação — desta vez selecionando o produto de Pix Cobranças — e gerar um certificado digital para autenticar a comunicação.

Antes de iniciar, solicite ao seu gerente de contas do Banco do Brasil:

  • A chave PIX que será usada para receber as cobranças.
  • A confirmação de que sua conta tem o produto Pix Cobranças contratado.

Passo a passo

No Portal Developers BB

  1. Acesse o Portal Developers BB. Se ainda não tem cadastro, clique em Cadastre-se e siga o processo; caso já tenha, faça o login.
  2. Vá em Aplicações → Criar nova aplicação.
  3. Preencha Nome da integração com Fácil123 PIX e Descrição com API PIX Fácil123 → habilite o produto Pix Cobranças → Criar.
  4. Clique na aplicação criada → Enviar para produção.
  5. Em Identificação da empresa, digite seu CNPJ → Pesquisar CNPJ → Próximo. Em Revisão da aplicação clique em Solicitar produção → leia os Termos de Uso → selecione Li e concordo com os Termos de Uso do Portal → Concordar.
  6. Clique na aplicação já em produção → Credenciais. Guarde os códigos Developer Application Key, Client ID e Client Secret — eles serão usados no Fácil123 na próxima etapa.
  7. Ainda no Portal, gere o certificado digital da aplicação. Salve o arquivo do certificado e a senha definida — ambos serão usados no Fácil123.

No Fácil123

Primeiro, cadastre a conexão com a API do PIX do Banco do Brasil:

  1. Vá em Engrenagem → Conexão com API → Incluir → coloque o Nome como Banco do Brasil PIX → no Emissor selecione Banco do Brasil - Pix/Extrato.
  2. Preencha Client ID, Client Secret e Developer Application Key com os códigos obtidos no Portal Developers BB.
  3. No campo Certificado, envie o certificado digital gerado no Portal. Em Senha do certificado, informe a senha definida.
  4. Clique em Salvar → Testar.

Agora cadastre a conta PIX do Banco do Brasil:

  1. Vá em Financeiro → Contas → localize sua Conta Banco do Brasil (ou inclua uma nova, caso ainda não tenha) → Alterar.
  2. Habilite a opção Permitir cobrança por Pix com vencimento.
  3. Em Conta Pix, selecione Banco do Brasil em Emissor → em Conexão com API, selecione Banco do Brasil PIX → em Chave Pix, cole a chave PIX cadastrada no banco.
  4. Clique em Salvar.

Para terminar, vincule o meio de pagamento:

  1. Vá no menu Vendas → Meio de pagamento → clique em Pix → Alterar.
  2. No Nome coloque Pix Banco do Brasil → no Método de Pagto selecione Pix com vencimento → em Conta escolha a Conta Banco do Brasil → em NF-e / NFC-e selecione Pagamento Instantâneo (PIX) - Dinâmico → Salvar.

Prontinho! Você já pode emitir PIX com vencimento pelo Banco do Brasil no Fácil123.

Caso ocorram erros na emissão, avise o suporte o quanto antes para verificarmos.

Perguntas e respostas

1 - Posso usar a mesma aplicação do boleto para emitir PIX?
R: Não. O Banco do Brasil exige aplicações separadas no Portal Developers para boleto e para PIX, com permissões e certificado próprios para o PIX.

2 - A mesma conexão do PIX serve para importar o extrato bancário?
R: Sim. A conexão do tipo Banco do Brasil - Pix/Extrato é usada para ambos. Basta habilitar o produto Extrato na aplicação do Portal Developers BB e selecionar a mesma conexão na conta, como explicado em Extrato Bancário Banco do Brasil.