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
- 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.
- Vá em Aplicações → Criar nova aplicação.
- Preencha Nome da integração com Fácil123 PIX e Descrição com API PIX Fácil123 → habilite o produto Pix Cobranças → Criar.
- Clique na aplicação criada → Enviar para produção.
- 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.
- 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.
- 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:
- Vá em Engrenagem → Conexão com API → Incluir → coloque o Nome como Banco do Brasil PIX → no Emissor selecione Banco do Brasil - Pix/Extrato.
- Preencha Client ID, Client Secret e Developer Application Key com os códigos obtidos no Portal Developers BB.
- No campo Certificado, envie o certificado digital gerado no Portal. Em Senha do certificado, informe a senha definida.
- Clique em Salvar → Testar.
Agora cadastre a conta PIX do Banco do Brasil:
- Vá em Financeiro → Contas → localize sua Conta Banco do Brasil (ou inclua uma nova, caso ainda não tenha) → Alterar.
- Habilite a opção Permitir cobrança por Pix com vencimento.
- 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.
- Clique em Salvar.
Para terminar, vincule o meio de pagamento:
- Vá no menu Vendas → Meio de pagamento → clique em Pix → Alterar.
- 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.