Como Configurar o PIX do Banco do Brasil para Receber Direto na Conta da Empresa

Para receber PIX pelo Banco do Brasil no Berga, crie uma aplicação com a API PIX no Portal Developers BB, cadastre o certificado digital e-CNPJ da empresa no Berga e informe as credenciais e a chave PIX em Integrações › PIX Banco do Brasil. As cobranças PIX das faturas e do PDV passam a cair direto na conta da empresa no Banco do Brasil.

Abrir PIX Banco do Brasil

Antes de começar

• Conta corrente Pessoa Jurídica no Banco do Brasil
• Chave PIX da empresa cadastrada nessa conta (CNPJ, e-mail, celular ou chave aleatória)
• Certificado digital e-CNPJ A1 da empresa, válido. O Banco do Brasil exige esse certificado em toda comunicação do PIX
• Acesso ao Portal Developers BB (developers.bb.com.br) com o usuário da empresa

Se você já usa o boleto do Banco do Brasil no Berga, pode aproveitar a mesma aplicação do portal: basta incluir nela a API PIX.

Como criar a aplicação no Portal Developers BB

1. 1
   Entre em developers.bb.com.br e clique em Criar uma nova aplicação (ou abra a aplicação que você já usa para o boleto).
2. 2
   Inclua a API PIX com as permissões de criar e consultar cobranças, consultar PIX recebidos e gerenciar webhook.
3. 3
   Peça a liberação da aplicação para produção. Nessa etapa o portal pede a cadeia do certificado digital: envie a do mesmo e-CNPJ que você vai cadastrar no Berga.
4. 4
   Com a aplicação em produção, abra Credenciais e copie o Client ID, o Client Secret e a developer_application_key.

A liberação para produção depende do Banco do Brasil e pode levar alguns dias. Se travar, fale com a gerência da sua conta informando que a API PIX é para receber cobranças da empresa.

As credenciais de teste (homologação) não servem para o Berga: use sempre as de produção.

Como cadastrar o certificado digital

1. 1
   Acesse Configurações › Certificado Digital.
2. 2
   Envie o arquivo do e-CNPJ A1 (.pfx) e informe a senha.
3. 3
   Confira se a validade aparece corretamente.

Se a empresa já emite nota fiscal pelo Berga, o certificado provavelmente já está cadastrado: só confira a validade.

Como ativar o PIX do Banco do Brasil no Berga

1. 1
   Acesse Integrações › PIX Banco do Brasil.
2. 2
   Ative Receber PIX pelo Banco do Brasil.
3. 3
   Em Aplicação no Portal Developers BB, cole o Client ID, o Client Secret e a Chave da aplicação (developer_application_key). Se o boleto do Banco do Brasil já estiver configurado e a aplicação tiver a API PIX, clique em Usar a mesma aplicação do boleto.
4. 4
   Em Recebimento, informe a Chave PIX da empresa.
5. 5
   Clique em Salvar configurações.

Depois de salvar, o quadro de status no topo da tela testa as credenciais, a conexão com o Banco do Brasil e a validade do certificado. Se algum item aparecer com erro, a mensagem indica o que corrigir.

Ao voltar à tela, os dados da aplicação aparecem mascarados. Para trocar só a chave PIX, deixe esses campos em branco e salve: os valores atuais são mantidos.

Como o pagamento é baixado

Na seção Aviso de pagamento (webhook), clique em Cadastrar no Banco do Brasil. Com o aviso cadastrado, o PIX pago é baixado assim que o banco avisa.

Mesmo sem o aviso, o PIX pago não fica em aberto: o Berga confere as cobranças PIX pendentes no Banco do Brasil a cada 2 minutos e dá baixa nas que foram pagas. Antes de dar baixa, o Berga sempre confere o valor e o horário do pagamento no banco.

Resultado esperado

As cobranças PIX das faturas e do PDV saem pelo Banco do Brasil com a sua empresa como recebedora, o dinheiro cai direto na sua conta e a fatura é baixada automaticamente quando o cliente paga.

Se der errado

Artigos relacionados

• Como Configurar o Banco do Brasil como Provedor Próprio de Boletos